Función CryptUIDlgSelectCertificate

La función CryptUIDlgSelectCertificate muestra un cuadro de diálogo que permite a un usuario seleccionar un certificado.

Sintaxis

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Parámetros

pcsc [in]

Puntero a una estructura de CRYPTUI_SELECTCERTIFICATE_STRUCT que contiene información sobre el cuadro de diálogo que se va a mostrar.

Valor devuelto

Puntero a una estructura de CERT_CONTEXT que representa el certificado seleccionado por el usuario. Cuando haya terminado de usar este certificado, debe pasar este puntero a la función CertFreeCertificateContext para disminuir el recuento de referencias del contexto del certificado.

Si el miembro dwFlags de la estructura pcsc no contiene la marca CRYPTUI_SELECTCERT_MULTISELECT , un valor devuelto de NULL significa que el usuario cerró el cuadro de diálogo sin seleccionar un certificado.

Si el miembro dwFlags de la estructura pcsc contiene la marca CRYPTUI_SELECTCERT_MULTISELECT , esta función siempre devuelve NULL. Los certificados seleccionados se incluirán en el almacén de certificados representado por el miembro hSelectedCertStore de pcsc. Si el número de certificados del almacén es el mismo antes y después de llamar a CryptUIDlgSelectCertificate, el usuario cerró el cuadro de diálogo sin seleccionar ningún certificado.

Comentarios

Si el miembro dwFlags de la estructura CRYPTUI_SELECTCERTIFICATE_STRUCT se establece en CRYPTUI_SELECTCERT_LEGACY, se muestra el cuadro de diálogo heredado. De lo contrario, se muestra el cuadro de diálogo de selección del certificado actual.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Finalización del soporte técnico	Windows 7 [solo aplicaciones de escritorio]
Biblioteca	Cryptui.lib
Archivo DLL	Cryptui.dll
Nombres Unicode y ANSI	CryptUIDlgSelectCertificateW (Unicode) y CryptUIDlgSelectCertificateA (ANSI)

Consulte también

CRYPTUI_SELECTCERTIFICATE_STRUCT