[Now Supported on Windows NT]
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
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 to be returned within the specified file.
Certificate
This provides a buffer to receive the desired certificate data.
RequiredLength
On input, this supplies the length of the Certificate buffer in bytes. On return, it receives the length of the requested certificate.
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 ImageGetCertificateData function returns a complete certificate from a file.
Windows NT: This function is not available under Windows NT 3.51; it was introduced in Windows NT 4.0.