Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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.

Syntax 

DWORD WINAPI CertEnumCertificateContextProperties(
  PCCERT_CONTEXT 
pCertContext,
  DWORD 
dwPropId
);

Parameters

pCertContext

[in] Pointer to the CERT_CONTEXTstructure of the certificate containing the properties to be enumerated.

dwPropId

[in] Specifies the property number of the last property enumerated. To get the first property, the dwPropIdparameter is zero. To retrieve subsequent properties, the dwPropIdparameteris 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 CertGetCertificateContextPropertyfunction with the dwPropIdparameter returned by this function to retrieve that property's data.

Return Value

The return value is a DWORDvalue that identifies a certificate context's property. The DWORDvalue returned by one call of the function can be supplied as the dwPropIdparameter 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

Header wincrypt.h
Library crypt32.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also