CertEnumCertificateContextProperties

Windows CE 3.0

This function retrieves the first or next extended property associated with a certificate context. Used in a loop, this function can retrieve in sequence all of the extended properties associated with a certificate context.

DWORD WINAPI CertEnumCertificateContextProperties(
PCCERT_CONTEXT pCertContext,
DWORD dwPropId
);

Parameters

pCertContext
[in] Pointer to the CERT_CONTEXT structure of the certificate containing the properties to be enumerated.
dwPropId
[in] Property number of the last property enumerated. To get the first property, the dwPropId parameter is zero. To retrieve subsequent properties, the dwPropId parameter is set to the property number returned by the last call to the function. To enumerate all the properties, function calls continue until the function returns zero.

Applications can call the CertGetCertificateContextProperty function with the dwPropId parameter returned by this function to retrieve that property's data.

Return Values

The return value is a DWORD value that identifies a certificate context's property. The DWORD value returned by one call of the function can be supplied as the dwPropId parameter in a subsequent call to the function. If there are no more properties to be enumerated or if the function fails, zero is returned.

Remarks

CERT_KEY_PROV_HANDLE_PROP_ID and CERT_KEY_SPEC_PROP_ID properties are stored as members of the CERT_KEY_CONTEXT_PROP_ID property. They are not enumerated individually.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 3.0 or later Wincrypt.h   Crypt32.lib
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CertGetCertificateContextProperty, CERT_CONTEXT


 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.

Show: