The WinTrustSubjectEnumCertificates function determines the types of certificates bundled within a subject. You can retrieve a list of all the certificate types that the subject contains, or you can determine whether the subject contains a specified certificate type.
BOOL WinTrustSubjectEnumCertificates(
LPWIN_TRUST_SIP_SUBJECT lpSubject, |
// pointer to description of the subject |
DWORD dwTypeFilter, |
// type of certificate to enumerate |
LPDWORD lpCertificateCount, |
// receives number of certificates of the specified type |
LPDWORD lpIndices, |
// pointer to an array that receives the certificate types |
DWORD dwIndexCount |
// size of the array |
); |
Value |
Meaning |
WIN_CERT_TYPE_X509 |
The certificate contains an X.509 Certificate. |
WIN_CERT_TYPE_PKCS_SIGNED_DATA |
The certificate contains a PKCS SignedData structure. |
WIN_CERT_TYPE_RESERVED_1 |
Reserved. |
The value returned in lpCertificateCount indicates the number of valid
entries returned in the array. If dwIndexCount is less than the value
returned in lpCertificateCount, the array contains garbage, and you
need to call WinTrustSubjectEnumCertificates again with a larger array.
If the function succeeds, the return value is a nonzero value.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
A trust provider calls the WinTrustSubjectEnumCertificates function to retrieve the types of certificates in the specified subject. The trust provider calls the WinTrust implementation of this function. WinTrust then calls the WinTrustSubjectEnumCertificates implementation of the appropriate Subject Interface Package (SIP). The appropriate SIP is the one registered to handle the type of subject specified by the lpSubject parameter.
Each Subject Interface Package (SIP) DLL must implement the WinTrustSubjectEnumCertificates function. WinTrust gets a pointer to the SIP’s WinTrustSubjectEnumCertificates implementation when WinTrust calls the SIP’s WinTrustSipInitialize initialization function.
The LPWINTRUST_SUBJECT_ENUM_CERTIFICATES type is a pointer to a WinTrustSubjectEnumCertificates function.
WIN_TRUST_SIP_SUBJECT, WinTrustSipInitialize
file: /Techref/os/win/api/win32/func/src/f91_28.htm, 5KB, , updated: 2000/4/7 12:13, local time: 2024/8/17 10:25,
3.137.173.79:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://techref.massmind.org/techref/os/win/api/win32/func/src/f91_28.htm"> WinTrustSubjectEnumCertificates</A> |
Did you find what you needed? |
Welcome to massmind.org! |
Welcome to techref.massmind.org! |
.