ImageGetCertificateData

The ImageGetCertificateData function is used to return a complete certificate from a file.

BOOL ImageGetCertificateData(
  IN HANDLE FileHandle,               
  IN DWORD CertificateIndex,          
  OUT PDICE_CERTIFICATE Certificate,  
  IN OUT PDWORD RequiredLength        
);
 

Parameters

FileHandle

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

CertificateIndex

Specifies the index of the certificate to be returned.

Certificate

Specifies a buffer to receive the certificate data.

RequiredLength

On input, this parameter specifies the length of the Certificate buffer in bytes. On return, it receives the length of the certificate.

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.

Remarks

The ImageGetCertificateData function returns a complete certificate from a file.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in imagehlp.h.
  Import Library: Use imagehlp.lib.

See Also

PE Image Helper (ImageHlp) Overview, Image Integrity