====== hfzHeader_DecodeExtHeaderBuf ======

===== Description =====

Decode a byte array from the extended header field of a HF2/HFZ file into the array of hfzExtHeaderBlock structs in a hfzHeader struct (see pExtHeaderBlocks member). 

===== Function prototype =====

<code>long hfzHeader_DecodeExtHeaderBuf(hfzHeader &fh, char* pBuf);</code>


===== Arguments =====

^ Name ^ Type ^ Comment ^
| fh | hfzHeader& | The hfzHeader struct corresponding to the extended header buffer, the //pExtHeaderBlocks// array of which will be initialised and filled with the extended header blocks. |
| pBuf | char* | The raw byte array of the extended header from the HF2/HFZ file. |

===== Return value =====

The number of blocks decoded (if 0 or greater), or otherwise an error code. Use [[libhfz:functions:hfzGetErrorStr]] to retrieve the error description. 


===== Comments =====

<note important>
This function is used internally within LibHFZ to decode the extended headers in HFZ/HF2 files. Developers would not normally need to use this function.
</note>