struttura CRYPTUI_VIEWCERTIFICATE_STRUCTA (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;

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.

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

Fabbisogno

Vedere anche

CryptUIDlgViewCertificate