estructura CRYPTUI_VIEWCERTIFICATE_STRUCTA (cryptuiapi.h)
La estructura CRYPTUI_VIEWCERTIFICATE_STRUCT contiene información sobre un certificado que se va a ver. Esta estructura se usa en la función
Sintaxis
typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTA {
DWORD dwSize;
HWND hwndParent;
DWORD dwFlags;
LPCSTR szTitle;
PCCERT_CONTEXT pCertContext;
LPCSTR *rgszPurposes;
DWORD cPurposes;
union {
CRYPT_PROVIDER_DATA const *pCryptProviderData;
HANDLE hWVTStateData;
};
BOOL fpCryptProviderDataTrustedUsage;
DWORD idxSigner;
DWORD idxCert;
BOOL fCounterSigner;
DWORD idxCounterSigner;
DWORD cStores;
HCERTSTORE *rghStores;
DWORD cPropSheetPages;
LPCPROPSHEETPAGEA rgPropSheetPages;
DWORD nStartPage;
} CRYPTUI_VIEWCERTIFICATE_STRUCTA, *PCRYPTUI_VIEWCERTIFICATE_STRUCTA;
Miembros
dwSize
Tamaño, en bytes, de la estructura CRYPTUI_VIEWCERTIFICATE_STRUCT.
hwndParent
Identificador de la ventana que es el elemento primario del cuadro de diálogo generado por CryptUIDlgViewCertificate.
dwFlags
Este miembro puede ser uno o varios de los siguientes valores.
| Valor | Significado |
|---|---|
|
La página ruta de certificación de |
|
La página Detalles de |
|
El usuario no puede cambiar las propiedades. |
|
El usuario puede cambiar las propiedades. |
|
El botón Instalar |
|
El botón Instalar está habilitado. |
|
Las páginas o botones que permiten al usuario aceptar o rechazar cualquier decisión están deshabilitadas. |
|
Se omite un error raíz que no es de confianza. |
|
Los almacenes de confianza conocidos no se usarán para crear la cadena. |
|
No se usará un almacén raíz de confianza conocido para crear la cadena. |
|
Use solo al ver certificados en equipos remotos. Si se usa esta marca, el primer elemento de rghStores debe ser el identificador del almacén raíz en el equipo remoto. |
|
Habilite la comprobación de revocación con el comportamiento predeterminado. El comportamiento predeterminado es habilitar la comprobación de revocación de toda la cadena de certificados, excepto el certificado raíz. Válido solo si no se pasa ni el |
|
Al compilar una cadena de certificados para un equipo remoto, avisa de que es posible que la cadena no sea de confianza en el equipo remoto. |
|
Si se establece esta marca, el |
|
Habilite la comprobación de revocación solo en el certificado hoja de la cadena de certificados. Válido solo si no se pasa ni el |
|
Habilite la comprobación de revocación en cada certificado de la cadena de certificados. Válido solo si no se pasa ni el Nota Dado que los certificados raíz rara vez contienen información que permite la comprobación de revocación, se espera que el uso de esta opción produzca normalmente errores de la función CryptUIDlgViewCertificate. La opción recomendada es usar CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT. |
|
Habilite la comprobación de revocación en cada certificado de la cadena de certificados, excepto el certificado raíz. Esta es la opción recomendada para usar para la comprobación de revocación de certificados. Válido solo si no se pasa ni el Nota Esta marca es equivalente a CRYPTUI_ENABLE_REVOCATION_CHECKING. |
|
Deshabilite el botón Ayuda HTML ( |
|
Deshabilite el botón |
|
Deshabilite la comprobación de revocación en línea. Establezca esta marca para asegurarse de que la función Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Esta marca no se admite. |
szTitle
Puntero a una cadena terminada en null que contiene el título de la ventana.
pCertContext
Puntero a la estructura CERT_CONTEXT que contiene el contexto del certificado que se va a mostrar.
rgszPurposes
Matriz de punteros a cadenas terminadas en null que contienen los fines para los que se validará este certificado.
cPurposes
Número de propósitos de la matriz rgszPurposes.
pCryptProviderData
Si ya se ha llamado a la función winVerifyTrust
hWVTStateData
Si ya se ha llamado
fpCryptProviderDataTrustedUsage
Si se llamó a winVerifyTrust, este es el resultado de si el certificado era de confianza.
idxSigner
Índice del firmante que se va a ver.
idxCert
Índice del certificado que se está viendo dentro de la cadena del firmante. El contexto de certificado de este certificado debe coincidir con pCertContext.
fCounterSigner
TRUE si se está viendo una contrafirma. Si se trata de TRUE, idxCounterSigner debe ser válido.
idxCounterSigner
Índice del contador que se va a ver.
cStores
El número de otros almacenes de la rghStores matriz de almacenes de certificados que se van a buscar al compilar y validar la cadena de certificados.
rghStores
Matriz de HCERTSTORE controla otros almacenes de certificados para buscar al compilar y validar la cadena de certificados.
cPropSheetPages
Número de páginas de propiedades que se van a agregar al cuadro de diálogo.
rgPropSheetPages
Matriz de páginas de propiedades que se van a agregar al cuadro de diálogo. Cada página de esta matriz no recibirá el
nStartPage
Índice de la página inicial que se mostrará. Si se establece el bit más alto (0x8000), se supone que el índice rgPropSheetPages (después de quitar el bit más alto, por ejemplo, 0x8000 indicará la primera página de rgPropSheetPages). Si el bit más alto es cero, nStartPage será el índice inicial de las páginas de propiedades del cuadro de diálogo de certificado predeterminado.
Observaciones
Nota
El encabezado cryptuiapi.h define CRYPTUI_VIEWCERTIFICATE_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 |
cryptuiapi.h |