ImageEnumerateCertificates

[Now Supported on Windows NT]

The ImageEnumerateCertificates function is used to return information about the certificates currently contained in an image file.

BOOL ImageEnumerateCertificates(

IN HANDLE FileHandle,
IN DWORD TypeFilter,
OUT PDWORD CertificateCount,
IN OUT PDWORD Indices OPTIONAL,
IN OUT DWORD IndexCount OPTIONAL
);

Parameters

FileHandle

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

TypeFilter

This supplies a DICE certificate section type to be used as a filter when returning certificate information. DICE_SECTION_TYPE_ANY should be passed for information on all section types present in the image.

CertificateCount

This is filled in with the number of certificates in the image containing sections of the type specified by the TypeFilter parameter. If none are found, this parameter will return zero .

Indices

This optionally provides a buffer to use to return an array of indices to the certificates containing sections of the specified type. No ordering should be assumed for the index values, nor are they guaranteed to be contiguous when DICE_SECTION_TYPE_ANY is queried.

IndexCount

This supplies the length in DWORDs of the Indices buffer. This parameter will be examined whenever Indices is present. If CertificateCount is greater than IndexCount, Indices will be filled in with the first IndexCount sections found in the image and an appropriate warning will be returned.

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 ImageEnumerateCertificates function returns information about the certificates currently contained in an image file. It has filtering capabilities which allow certificates containing sections of any single type (or of any type) to be returned.

Once the indices of interesting certificates are discovered, they can be passed into ImageGetCertificateData to obtain the actual bodies of the certificates.

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

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples

Databases for Amazon shops developers

Amazon Categories Database
Browse Nodes Database