CRYPTUI_VIEWCERTIFICATE_STRUCTA struttura (cryptuiapi.h)
La struttura CRYPTUI_VIEWCERTIFICATE_STRUCT contiene informazioni su un certificato da visualizzare. Questa struttura viene usata nella funzione CryptUIDlgViewCertificate .
Sintassi
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;
Members
dwSize
Dimensioni, in byte, della struttura CRYPTUI_VIEWCERTIFICATE_STRUCT .
hwndParent
Handle della finestra padre della finestra prodotta da CryptUIDlgViewCertificate.
dwFlags
Questo membro può essere uno o più dei valori seguenti.
Valore | Significato |
---|---|
|
La pagina Percorso di certificazione è disabilitata. |
|
La pagina Dettagli è disabilitata. |
|
L'utente non è autorizzato a modificare le proprietà. |
|
L'utente può modificare le proprietà. |
|
Il pulsante Installa è disabilitato. |
|
Il pulsante Installa è abilitato. |
|
Le pagine o i pulsanti che consentono all'utente di accettare o rifiutare qualsiasi decisione sono disabilitati. |
|
Viene ignorato un errore radice non attendibile. |
|
Gli archivi attendibili noti non verranno usati per compilare la catena. |
|
Un archivio radice attendibile noto non verrà usato per compilare la catena. |
|
Usare solo quando si visualizzano i certificati nei computer remoti. Se questo flag viene usato, il primo elemento di rghStores deve essere l'handle dell'archivio radice nel computer remoto. |
|
Abilitare il controllo delle revoche con il comportamento predefinito. Il comportamento predefinito consiste nell'abilitare il controllo della revoca dell'intera catena di certificati, ad eccezione del certificato radice. Valido solo se non vengono passati né pCryptProviderData né il membro dell'unione hWVTStateData . |
|
Quando si compila una catena di certificati per un computer remoto, si avvisa che la catena potrebbe non essere attendibile nel computer remoto. |
|
Se questo flag è impostato, il pulsante Copia nel file verrà disabilitato nella pagina Dettagli . |
|
Abilitare il controllo della revoca solo sul certificato foglia nella catena di certificati. Valido solo se non vengono passati né pCryptProviderData né il membro dell'unione hWVTStateData . |
|
Abilitare il controllo della revoca su ogni certificato nella catena di certificati. Valido solo se non vengono passati né pCryptProviderData né il membro dell'unione hWVTStateData .
Nota Poiché i certificati radice contengono raramente informazioni che consentono il controllo della revoca, si prevede che l'uso di questa opzione genererà un errore della funzione CryptUIDlgViewCertificate . L'opzione consigliata consiste nell'usare CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT. |
|
Abilitare il controllo della revoca su ogni certificato nella catena di certificati, ad eccezione del certificato radice. Questa è l'opzione consigliata da usare per il controllo della revoca dei certificati. Valido solo se non vengono passati né pCryptProviderData né il membro dell'unione hWVTStateData .
Nota Questo flag equivale a CRYPTUI_ENABLE_REVOCATION_CHECKING. |
|
Disabilitare il pulsante Guida HTML (?) nella finestra di dialogo Certificato . |
|
Disabilitare il pulsante Istruzione autorità di certificazione nella scheda Generale della finestra di dialogo Certificato . |
|
Disabilitare il controllo della revoca online. Impostare questo flag per assicurarsi che la funzione CryptUIDlgViewCertificate usi la cache locale per recuperare il certificato e non tenta di recuperare il certificato dalla rete.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo flag non è supportato. |
szTitle
Puntatore a una stringa con terminazione null contenente il titolo per la finestra.
pCertContext
Puntatore alla struttura CERT_CONTEXT che contiene il contesto del certificato da visualizzare.
rgszPurposes
Matrice di puntatori a stringhe con terminazione null che contengono gli scopi per cui questo certificato verrà convalidato.
cPurposes
Numero di scopi nella matrice rgszPurposes .
pCryptProviderData
Se la funzione WinVerifyTrust è già stata chiamata per il certificato e la funzione WTHelperProvDataFromStateData è stata chiamata anche, passare un puntatore alla struttura di stato acquisita dalla chiamata a WTHelperProvDataFromStateData. Se pCryptProviderData è impostato, è necessario impostare anche fpCryptProviderDataTrustedUsage, idxSigner, idxCert e fCounterSignature.
hWVTStateData
Se WinVerifyTrust è già stato chiamato per il certificato e WTHelperProvDataFromStateData non è stato chiamato, passare il membro hWVTStateData della struttura WINTRUST_DATA . Se hWVTStateData è impostato, è necessario impostare anche fpCryptProviderDataTrustedUsage, idxSigner, idxCert e fCounterSignature.
fpCryptProviderDataTrustedUsage
Se WinVerifyTrust è stato chiamato, questo è il risultato del fatto che il certificato fosse attendibile.
idxSigner
Indice del firmatario da visualizzare.
idxCert
Indice del certificato visualizzato all'interno della catena di firma. Il contesto del certificato di questo certificato deve corrispondere a pCertContext.
fCounterSigner
TRUE se viene visualizzata una controfirma. Se si tratta di TRUE, idxCounterSigner deve essere valido.
idxCounterSigner
Indice del contatore da visualizzare.
cStores
Numero di altri archivi nella matrice rghStores di archivi certificati da cercare durante la compilazione e la convalida della catena di certificati.
rghStores
Matrice di handle HCERTSTORE ad altri archivi certificati da cercare durante la compilazione e la convalida della catena di certificati.
cPropSheetPages
Numero di pagine delle proprietà da aggiungere alla finestra di dialogo.
rgPropSheetPages
Matrice di pagine delle proprietà da aggiungere alla finestra di dialogo. Ogni pagina in questa matrice non riceverà lParam nella struttura PROPSHEETPAGE come lParam nel messaggio di WM_INITDIALOG. Riceverà invece un puntatore a una struttura CRYPTUI_INITDIALOG_STRUCT . Contiene lParam in PROPSHEETPAGE e il puntatore alla CERT_CONTEXT per cui viene visualizzata la pagina.
nStartPage
Indice della pagina iniziale che verrà visualizzata. Se viene impostato il bit più alto (0x8000), si presuppone che l'indice indicizza rgPropSheetPages (dopo che il bit più alto è stato rimosso, ad esempio, 0x8000 indicherà la prima pagina in rgPropSheetPages). Se il bit più alto è zero, nStartPage sarà l'indice iniziale delle pagine delle proprietà della finestra di dialogo del certificato predefinito.
Commenti
Nota
L'intestazione cryptuiapi.h definisce CRYPTUI_VIEWCERTIFICATE_STRUCT come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Intestazione | cryptuiapi.h |