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

Mark a block as precious and reorganize&period;

== Synopsis

Declared in `&lt;validation&period;h&gt;`

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

== Description

May not be called in a validationinterface callback&period;

== Return Value

true unless a system error occurred&period;

== Parameters

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


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