EN
Il contenuto non è disponibile nella lingua di destinazione, ma solo in inglese.

CertEnumCertificateContextProperties function

The CertEnumCertificateContextProperties 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(
  _In_  PCCERT_CONTEXT pCertContext,
  _In_  DWORD dwPropId
);

Parameters

pCertContext [in]

A 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, dwPropId is zero. To retrieve subsequent properties, dwPropId 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 CertGetCertificateContextProperty with the dwPropId returned by this function to retrieve that property's data.

Return value

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 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.

Examples

See Example C Program: Listing the Certificates in a Store.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Wincrypt.h

Library

Crypt32.lib

DLL

Crypt32.dll

See also

CertGetCertificateContextProperty
Extended Property Functions
CERT_CONTEXT

 

 

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft