[#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(0x7fb95fa38440), locks_excluded(0x7fb95fa38518), requires_capability(0x7fb96ac5f3a0), locks_excluded(0x7fb96ac5f478), requires_capability(0x7fb96e9d5bc0), locks_excluded(0x7fb96e9d5c98), requires_capability(0x7fb98748b230), locks_excluded(0x7fb98748b308)]]
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]#