Función CryptUIDlgSelectCertificateFromStore (cryptuiapi.h)

Artículo
08/22/2023

La función CryptUIDlgSelectCertificateFromStore muestra un cuadro de diálogo que permite la selección de un certificado de un almacén especificado.

Sintaxis

PCCERT_CONTEXT CryptUIDlgSelectCertificateFromStore(
  [in]           HCERTSTORE hCertStore,
  [in]           HWND       hwnd,
  [in, optional] LPCWSTR    pwszTitle,
  [in, optional] LPCWSTR    pwszDisplayString,
  [in]           DWORD      dwDontUseColumn,
  [in]           DWORD      dwFlags,
  [in]           void       *pvReserved
);

Parámetros

[in] hCertStore

Identificador del almacén de certificados que se va a buscar.

[in] hwnd

Identificador de la ventana de la pantalla. Si es NULL, el valor predeterminado es la ventana de escritorio.

[in, optional] pwszTitle

Cadena usada como título del cuadro de diálogo. Si es NULL, se usa el título predeterminado , "Seleccionar certificado".

[in, optional] pwszDisplayString

Instrucción text en el cuadro de diálogo de selección. Si es NULL, se usa la frase predeterminada "Select a certificate you want to use" (Seleccionar un certificado que quiera usar).

[in] dwDontUseColumn

Marcas que se pueden combinar para excluir columnas de la pantalla.

Valor	Significado
CRYPTUI_SELECT_ISSUEDTO_COLUMN	No muestre la información ISSUEDTO.
CRYPTUI_SELECT_ISSUEDBY_COLUMN	No muestre la información ISSUEDBY.
CRYPTUI_SELECT_INTENDEDUSE_COLUMN	No muestre la información de IntendedUse.
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN	No muestre la información del nombre para mostrar.
CRYPTUI_SELECT_LOCATION_COLUMN	No mostrar información de ubicación.
CRYPTUI_SELECT_EXPIRATION_COLUMN	No muestre la información de expiración.

[in] dwFlags

Actualmente no se usa y debe establecerse en 0.

[in] pvReserved

Reservado para uso futuro.

Valor devuelto

Devuelve un puntero al contexto de certificado seleccionado. Si no se seleccionó ningún certificado, se devuelve NULL . Cuando haya terminado de usar el certificado, libere el contexto del certificado llamando a la función CertFreeCertificateContext .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	cryptuiapi.h
Library	Cryptui.lib
Archivo DLL	Cryptui.dll

Consulte también

CryptUIDlgViewContext