[#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(0x7f2e1ba84750), locks_excluded(0x7f2e1ba84828), requires_capability(0x7f2e145643a0), locks_excluded(0x7f2e14564478), requires_capability(0x7f2e373bd550), locks_excluded(0x7f2e373bd628), requires_capability(0x7f2e36e341a0), locks_excluded(0x7f2e36e34278)]]
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]#