ImageGetCertificateHeader

[Now Supported on Windows NT]

The ImageGetCertificateHeader function is used to return only the header part of the specified DICE_CERTIFICATE up to, but not including, the section offset array.

BOOL ImageGetCertificateHeader(

IN HANDLE FileHandle,  
IN DWORD CertificateIndex,  
OUT PDICE_CERTIFICATE CertificateHeader  
);  

Parameters

FileHandle

This supplies a handle to the image file to be modified. This handle must be opened for FILE_READ_DATA access.

CertificateIndex

This provides the index of the certificate whose header is to be returned.

CertificateHeader

This provides a buffer to receive the desired certificate header.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, then the return value is FALSE. To retrieve extended error information, call GetLastError.

Remarks

The ImageGetCertificateHeader function returns only the header part of the specified DICE_CERTIFICATE up to, but not including, the section offset array.

Windows NT: This function is not available under Windows NT 3.51; it was introduced in Windows NT 4.0.