estructura de CRYPTUI_SELECTCERTIFICATE_STRUCT

La estructura CRYPTUI_SELECTCERTIFICATE_STRUCT contiene información sobre el cuadro de diálogo que muestra la función CryptUIDlgSelectCertificate .

Sintaxis

typedef struct _CRYPTUI_SELECTCERTIFICATE_STRUCT {
  DWORD               dwSize;
  HWND                hwndParent;
  DWORD               dwFlags;
  LPCTSTR             szTitle;
  DWORD               dwDontUseColumn;
  LPCTSTR             szDisplayString;
  PFNCFILTERPROC      pFilterCallback;
  PFNCCERTDISPLAYPROC pDisplayCallback;
  void                *pvCallbackData;
  DWORD               cDisplayStores;
  HCERTSTORE          *rghDisplayStores;
  DWORD               cStores;
  HCERTSTORE          *rghStores;
  DWORD               cPropSheetPages;
  LPCPROPSHEETPAGE    rgPropSheetPages;
  HCERTSTORE          hSelectedCertStore;
} CRYPTUI_SELECTCERTIFICATE_STRUCT, *PCRYPTUI_SELECTCERTIFICATE_STRUCT;

Miembros

dwSize

Tamaño, en bytes, de esta estructura.

hwndParent

Identificador de la ventana primaria del cuadro de diálogo. Si este valor es NULL, la ventana primaria es la ventana de escritorio predeterminada.

dwFlags

Especifica opciones adicionales para la función CryptUIDlgSelectCertificate . Puede ser cero o un OR bit a bit de los siguientes valores.

Valor	Significado
CRYPTUI_SELECTCERT_ADDFROMDS	Reservado.
CRYPTUI_SELECTCERT_LEGACY	Especifica que se va a mostrar el cuadro de diálogo heredado.
CRYPTUI_SELECTCERT_MULTISELECT	Permite al usuario seleccionar más de un certificado en el cuadro de diálogo. Si se establece esta marca, la función CryptUIDlgSelectCertificate siempre devuelve NULL. El miembro hSelectedCertStore de esta estructura debe contener un identificador para un almacén de certificados. Los certificados seleccionados por el usuario se agregarán a este almacén.
CRYPTUI_SELECTCERT_PUT_WINDOW_TOPMOST	Obliga a la interfaz de usuario de criptografía a ser la ventana superior de la pantalla.

 

szTitle

Título para mostrar del cuadro de diálogo. Si el valor de este miembro es NULL, se usa el título predeterminado de "Seleccionar certificado".

dwDontUseColumn

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

Valor	Significado
CRYPTUI_SELECT_ISSUEDTO_COLUMN 1 (0x1)	No muestre la información ISSUEDTO .
CRYPTUI_SELECT_ISSUEDBY_COLUMN 2 (0x2)	No muestre la información ISSUEDBY .
CRYPTUI_SELECT_INTENDEDUSE_COLUMN 4 (0x4)	No muestre la información de IntendedUse .
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN 8 (0x8)	No mostrar información de nombre.
CRYPTUI_SELECT_LOCATION_COLUMN 16 (0x10)	No mostrar información de ubicación.
CRYPTUI_SELECT_EXPIRATION_COLUMN 32 (0x20)	No muestre la información de expiración.

 

szDisplayString

Texto que se muestra en el cuadro de diálogo para indicar al usuario. Si el valor de este miembro es NULL, se usa la cadena predeterminada "Seleccionar un certificado que desea usar".

pFilterCallback

Puntero a una función de devolución de llamada PFNCFILTERPROC que filtra los certificados que se muestran en el cuadro de diálogo.

pDisplayCallback

Puntero a una función de devolución de llamada PFNCCERTDISPLAYPROC que muestra los certificados que el usuario selecciona para ver.

pvCallbackData

Datos adicionales que se pasan a las funciones de devolución de llamada especificadas por los miembros pFilterCallback y pDisplayCallback .

cDisplayStores

Número de almacenes de certificados en la matriz rghDisplayStores .

rghDisplayStores

Puntero a una matriz de almacenes que contienen certificados disponibles para su selección en el cuadro de diálogo.

cStores

Número de almacenes de certificados en la matriz rghStores .

rghStores

Puntero a una matriz de almacenes de certificados que se van a buscar al crear una cadena de certificados y comprobar la confianza de los certificados mostrados en el cuadro de diálogo.

cPropSheetPages

Número de páginas de propiedades de la matriz rgPropSheetPages .

rgPropSheetPages

Puntero a una matriz de estructuras PROPSHEETPAGE que representan páginas de propiedades que se pasan al cuadro de diálogo de visualización de certificados cuando se selecciona un certificado para su visualización.

hSelectedCertStore

Identificador de un almacén de certificados creado por el autor de la llamada. Los certificados seleccionados por el usuario se agregan a este almacén. Si el número de certificados de este 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.

Este miembro no se usa si el miembro dwFlags de esta estructura no contiene la marca CRYPTUI_SELECTCERT_MULTISELECT .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Nombres Unicode y ANSI	CRYPTUI_SELECTCERTIFICATE_STRUCTW (Unicode) y CRYPTUI_SELECTCERTIFICATE_STRUCTA (ANSI)

Consulte también

CryptUIDlgSelectCertificate