struttura CRYPTUI_VIEWCERTIFICATE_STRUCTW (cryptuiapi.h)

Articolo
11/20/2024

La struttura CRYPTUI_VIEWCERTIFICATE_STRUCT contiene informazioni su un certificato da visualizzare. Questa struttura viene usata nella funzione CryptUIDlgViewCertificate.

Sintassi

typedef struct tagCRYPTUI_VIEWCERTIFICATE_STRUCTW {
  DWORD             dwSize;
  HWND              hwndParent;
  DWORD             dwFlags;
  LPCWSTR           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;
  LPCPROPSHEETPAGEW rgPropSheetPages;
  DWORD             nStartPage;
} CRYPTUI_VIEWCERTIFICATE_STRUCTW, *PCRYPTUI_VIEWCERTIFICATE_STRUCTW;

Membri

dwSize

Dimensione, in byte, della struttura CRYPTUI_VIEWCERTIFICATE_STRUCT.

hwndParent

Handle della finestra padre della finestra generata da CryptUIDlgViewCertificate.

dwFlags

Questo membro può essere uno o più dei valori seguenti.

Valore	Significato
CRYPTUI_HIDE_HIERARCHYPAGE	La pagina percorso di certificazione è disabilitata.
CRYPTUI_HIDE_DETAILPAGE	La pagina dettagli è disabilitata.
CRYPTUI_DISABLE_EDITPROPERTIES	L'utente non è autorizzato a modificare le proprietà.
CRYPTUI_ENABLE_EDITPROPERTIES	L'utente può modificare le proprietà.
CRYPTUI_DISABLE_ADDTOSTORE	Il pulsante Installa è disabilitato.
CRYPTUI_ENABLE_ADDTOSTORE	Il pulsante Installa è abilitato.
CRYPTUI_ACCEPT_DECLINE_STYLE	Le pagine o i pulsanti che consentono all'utente di accettare o rifiutare qualsiasi decisione sono disabilitati.
CRYPTUI_IGNORE_UNTRUSTED_ROOT	Un errore radice non attendibile viene ignorato.
CRYPTUI_DONT_OPEN_STORES	Gli archivi attendibili noti non verranno usati per compilare la catena.
CRYPTUI_ONLY_OPEN_ROOT_STORE	Un archivio radice attendibile noto non verrà usato per compilare la catena.
CRYPTUI_WARN_UNTRUSTED_ROOT	Usare solo quando si visualizzano i certificati nei computer remoti. Se viene usato questo flag, il primo elemento di rghStores deve essere l'handle dell'archivio radice nel computer remoto.
CRYPTUI_ENABLE_REVOCATION_CHECKING	Abilitare il controllo delle revoche con il comportamento predefinito. Il comportamento predefinito consiste nell'abilitare il controllo delle revoche dell'intera catena di certificati, ad eccezione del certificato radice. Valido solo se non viene passato né il pCryptProviderData né il membro hWVTStateData union.
CRYPTUI_WARN_REMOTE_TRUST	Quando si compila una catena di certificati per un computer remoto, avvisare che la catena potrebbe non essere considerata attendibile nel computer remoto.
CRYPTUI_DISABLE_EXPORT	Se questo flag è impostato, il pulsante Copia nel file verrà disabilitato nella pagina dettagli .
CRYPTUI_ENABLE_REVOCATION_CHECK_END_CERT	Abilitare il controllo delle revoche solo sul certificato foglia nella catena di certificati. Valido solo se non viene passato né il pCryptProviderData né il membro hWVTStateData union.
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN	Abilitare il controllo delle revoche per ogni certificato nella catena di certificati. Valido solo se non viene passato né il pCryptProviderData né il membro hWVTStateData union. Nota Poiché i certificati radice contengono raramente informazioni che consentono il controllo delle revoche, è previsto che l'uso di questa opzione genererà un errore del funzione CryptUIDlgViewCertificate. L'opzione consigliata consiste nell'usare CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT.
CRYPTUI_ENABLE_REVOCATION_CHECK_CHAIN_EXCLUDE_ROOT	Abilitare il controllo delle revoche per ogni certificato nella catena di certificati, ad eccezione del certificato radice. Questa è l'opzione consigliata da usare per il controllo delle revoche di certificati. Valido solo se non viene passato né il pCryptProviderData né il membro hWVTStateData union. Nota Questo flag equivale a CRYPTUI_ENABLE_REVOCATION_CHECKING.
CRYPTUI_DISABLE_HTMLLINK	Disabilitare il pulsante Guida HTML (?) nella finestra di dialogo certificato .
CRYPTUI_DISABLE_ISSUERSTATEMENT	Disabilitare il pulsante istruzione autorità di certificazione nella scheda generale della finestra di dialogo certificato.
CRYPTUI_CACHE_ONLY_URL_RETRIEVAL	Disabilitare il controllo delle revoche online. Impostare questo flag per assicurarsi che la funzione CryptUIDlgViewCertificate usi la cache locale per recuperare il certificato e non tenti 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 il certificato verrà convalidato.

cPurposes

Numero di scopi nella matrice rgszPurposes.

pCryptProviderData

Se è già stata chiamata la funzione WinVerifyTrust per il certificato e la funzione WTHelperProvDataFromStateData è stata chiamata, passare un puntatore alla struttura di stato acquisita dalla chiamata a WTHelperProvDataFromStateData. Se è impostato pCryptProviderData, è necessario impostare fpCryptProviderDataTrustedUsage, idxSigner, idxCerte fCounterSignature.

hWVTStateData

Se WinVerifyTrust è già stato chiamato per il certificato e non è stato chiamato il WTHelperProvDataFromStateData, passare il hWVTStateData membro della struttura WINTRUST_DATA. Se è impostato hWVTStateData, fpCryptProviderDataTrustedUsage, idxSigner, idxCerte deve essere impostata anche fCounterSignature.

fpCryptProviderDataTrustedUsage

Se è stato chiamato WinVerifyTrust, questo è il risultato dell'attendibilità del certificato.

idxSigner

Indice del firmatario da visualizzare.

idxCert

Indice del certificato visualizzato all'interno della catena del firmatario. Il contesto del certificato di questo certificato deve corrispondere pCertContext.

fCounterSigner

TRUE se viene visualizzata una controfirma. Se si tratta di TRUE, idxCounterSigner deve essere valido.

idxCounterSigner

Indice del controfirmato da visualizzare.

cStores

Numero di altri archivi nella rghStores matrice di archivi certificati da cercare durante la compilazione e la convalida della catena di certificati.

rghStores

Matrice di HCERTSTORE handle in 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à il lParam nella struttura PROPSHEETPAGE come lParam nel messaggio di WM_INITDIALOG. Riceverà invece un puntatore a una struttura CRYPTUI_INITDIALOG_STRUCT. Contiene il lParam in PROPSHEETPAGE e il puntatore al 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.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	cryptuiapi.h

Vedere anche

CryptUIDlgViewCertificate

Condividi tramite