estructura CERT_SELECT_STRUCT_A (cryptdlg.h)

La estructura CERT_SELECT_STRUCT contiene criterios sobre los que seleccionar certificados que se presentan en un cuadro de diálogo de selección de certificado. Esta estructura se usa en la función certSelectCertificate .

Sintaxis

typedef struct tagCSSA {
  DWORD           dwSize;
  HWND            hwndParent;
  HINSTANCE       hInstance;
  LPCSTR          pTemplateName;
  DWORD           dwFlags;
  LPCSTR          szTitle;
  DWORD           cCertStore;
  HCERTSTORE      *arrayCertStore;
  LPCSTR          szPurposeOid;
  DWORD           cCertContext;
  PCCERT_CONTEXT  *arrayCertContext;
  LPARAM          lCustData;
  PFNCMHOOKPROC   pfnHook;
  PFNCMFILTERPROC pfnFilter;
  LPCSTR          szHelpFileName;
  DWORD           dwHelpId;
  HCRYPTPROV      hprov;
} CERT_SELECT_STRUCT_A, *PCERT_SELECT_STRUCT_A;

Miembros

dwSize

Tamaño, en bytes, de esta estructura.

hwndParent

Identificador de la ventana primaria de los cuadros de diálogo que certSelectCertificate genera.

hInstance

Identificador del módulo cuyo archivo ejecutable contiene la plantilla del cuadro de diálogo.

pTemplateName

Si la marca CSS_ENABLETEMPLATE se establece en el miembro dwFlags de , establezca pTemplateName en un puntero a un objeto de memoria global que contenga la plantilla que DialogBoxIndirectParam usa para crear el cuadro de diálogo. Una plantilla de cuadro de diálogo consta de un encabezado que describe el cuadro de diálogo. El encabezado va seguido de uno o varios bloques adicionales de datos que describen cada uno de los controles del cuadro de diálogo. La plantilla puede usar el formato estándar o el formato extendido.

Si la marca de CSS_ENABLETEMPLATEHANDLE está establecida en dwFlags, pTemplateName especifica la plantilla del cuadro de diálogo. pTemplateName es el puntero a una cadena de caracteres terminada en null que especifica el nombre de la plantilla del cuadro de diálogo o un valor entero que especifica el identificador de recursos de la plantilla del cuadro de diálogo. Si especifica un identificador de recurso, su palabra de orden superior debe ser cero y su palabra de orden bajo debe contener el identificador. Una manera de crear este valor entero es usar la macro de MAKEINTRESOURCE.

dwFlags

Este miembro puede ser uno o varios de los siguientes valores.

Valor	Significado
CSS_HIDE_PROPERTIES	Oculte el botón Propiedades de .
CSS_ENABLEHOOK	Pase un procedimiento de enlace en pfnHook.
CSS_ALLOWMULTISELECT	Habilite la selección múltiple de certificados. Esta opción no se admite actualmente y se omite.
CSS_SHOW_HELP	Muestra el botón ayuda de .
CSS_ENABLETEMPLATE	Haga que función certSelectCertificate llame a la función DialogBoxIndirectParam para crear un cuadro de diálogo. Para obtener más información, vea pTemplateName.
CSS_ENABLETEMPLATEHANDLE	Haga que la función CertSelectCertificate llame a la función DialogBoxParam para crear un cuadro de diálogo. Para obtener más información, vea pTemplateName.

szTitle

Puntero a una cadena que contiene el texto del título del cuadro de diálogo.

cCertStore

Número de elementos de matriz arrayCertStore.

arrayCertStore

Puntero a la matriz de almacenes de certificados de los que el cuadro de diálogo enumera y muestra los certificados. El miembro cCertStore contiene el número de elementos de esta matriz.

szPurposeOid

Puntero a una representación de cadena de un identificador de objeto (OID) para un uso mejorado de clave (EKU). Si se proporciona un OID, solo se mostrarán los certificados que incluyan esta EKU.

cCertContext

Número de elementos de la matriz arrayCertContext. Una vez que la función CertSelectCertificate devuelve, este miembro contiene el número de certificados seleccionados por el usuario. Actualmente, solo el usuario puede seleccionar un certificado.

arrayCertContext

Puntero a una matriz de estructuras CERT_CONTEXT. El miembro cCertContext especifica el número de elementos de esta matriz. Esta matriz debe contener al menos un elemento.

Los certificados representados por estas estructuras se seleccionan cuando se muestra inicialmente el cuadro de diálogo mostrado por la función CertSelectCertificate. Actualmente, solo se usa el primer certificado de esta matriz. El primer certificado de esta matriz se publicará con la función CertFreeCertificateContext si la función CertSelectCertificate es correcta. Si el primer elemento de esta matriz es NULL, no se selecciona inicialmente ningún certificado en el cuadro de diálogo.

Una vez que la función CertSelectCertificate devuelve, esta matriz contiene los certificados seleccionados por el usuario. Actualmente, solo el usuario puede seleccionar un certificado.

lCustData

Puntero a una matriz de valores de bytes que contienen datos personalizados que se pasan al procedimiento de filtro al que hace referencia pfnFilter. La función CertSelectCertificate no usa estos datos personalizados.

pfnHook

Puntero de función PFNCMHOOKPROC a la función de devolución de llamada hook. Se llama a esta función antes de que el cuadro de diálogo procese los mensajes. Para obtener más información, vea Enlaces.

pfnFilter

Puntero de función PFNCMFILTERPROC a la función de devolución de llamada de filtro. Se llama a para determinar qué certificados mostrará el cuadro de diálogo.

szHelpFileName

Puntero a una cadena terminada en null que contiene la ruta de acceso completa al archivo de Ayuda.

dwHelpId

Identificador de contexto del tema. Para obtener más información, consulte
WinHelp.

hprov

Identificador de la proveedor de servicios criptográficos (CSP) que se va a usar para la comprobación de certificados.

Observaciones

Nota

El encabezado cryptdlg.h define CERT_SELECT_STRUCT como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	cryptdlg.h

Consulte también

CertSelectCertificate