Función CertEnumCertificateContextProperties (wincrypt.h)

La función CertEnumCertificateContextProperties recupera la primera o siguiente propiedad extendida asociada a un contexto de certificado. Usada en un bucle, esta función puede recuperar en secuencia todas las propiedades extendidas asociadas a un contexto de certificado.

Sintaxis

DWORD CertEnumCertificateContextProperties(
  [in] PCCERT_CONTEXT pCertContext,
  [in] DWORD          dwPropId
);

Parámetros

[in] pCertContext

Puntero a la estructura CERT_CONTEXT del certificado que contiene las propiedades que se van a enumerar.

[in] dwPropId

Número de propiedad de la última propiedad enumerada. Para obtener la primera propiedad, dwPropId es cero. Para recuperar las propiedades posteriores, dwPropId se establece en el número de propiedad devuelto por la última llamada a la función. Para enumerar todas las propiedades, las llamadas de función continúan hasta que la función devuelve cero.

Las aplicaciones pueden llamar a CertGetCertificateContextProperty con el dwPropId devuelto por esta función para recuperar los datos de esa propiedad.

Valor devuelto

El valor devuelto es un valor DWORD que identifica la propiedad de un contexto de certificado . El valor DWORD devuelto por una llamada de la función se puede proporcionar como dwPropId en una llamada posterior a la función. Si no hay más propiedades que enumerar o si se produce un error en la función, se devuelve cero.

Comentarios

CERT_KEY_PROV_HANDLE_PROP_ID y CERT_KEY_SPEC_PROP_ID propiedades se almacenan como miembros de la propiedad CERT_KEY_CONTEXT_PROP_ID. No se enumeran individualmente.

Ejemplos

Vea Programa C de ejemplo: Enumeración de los certificados en un almacén.

Requisitos

Consulte también

CERT_CONTEXT

CertGetCertificateContextProperty

Funciones de propiedad extendidas