|
|
|
|
|
|
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| imagehlp.lib
| Header File
| imagehlp.h
| Unicode
| No
| Platform Notes
| Windows 95: IMAGEHLP is available as a redistributable.
|
|
|
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.
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
