ImageGetCertificateHeader

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

BOOL ImageGetCertificateHeader(
  HANDLE FileHandle,                    
  DWORD CertificateIndex,               
  LPWIN_CERTIFICATE CertificateHeader  
);

Parameters

FileHandle

[in] Handle to the image file to be modified. This handle must be opened for FILE_READ_DATA access.

CertificateIndex

[in] Specifies the index of the certificate whose header is to be returned.

CertificateHeader

[in/out] Pointer to the WIN_CERTIFICATE structure that receives the certificate header.

Return Values

If the function succeeds, the return value is TRUE.

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

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Imagehlp.h.
  Library: Use Imagehlp.lib.

See Also

Image Help Library Overview, ImageHlp Functions