[#Chainstate-PreciousBlock]
= xref:Chainstate.adoc[Chainstate]::PreciousBlock
:relfileprefix: ../
:mrdocs:

Mark a block as precious and reorganize.

== Synopsis

Declared in `<validation.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
[[requires_capability(0x7f9513ab4ae0), locks_excluded(0x7f9513ab4bb8), requires_capability(0x7f9502c97b50), locks_excluded(0x7f9502c97c28), requires_capability(0x7f9525449880), locks_excluded(0x7f9525449958), requires_capability(0x7f95173ffb60), locks_excluded(0x7f95173ffc38)]]
bool
PreciousBlock(
    xref:BlockValidationState.adoc[BlockValidationState]& state,
    xref:CBlockIndex.adoc[CBlockIndex]* pindex);
----

== Description

May not be called in a validationinterface callback.

== Return Value

true unless a system error occurred.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *state*
| Validation state updated with the reason for any failure.
| *pindex*
| Block index entry of the block to mark as precious.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#