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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | wincrypt.h |
| Library | Crypt32.lib |
| Archivo DLL | Crypt32.dll |