Funzione CryptUIDlgSelectCertificateFromStore (cryptuiapi.h)

Articolo
03/05/2024

La funzione CryptUIDlgSelectCertificateFromStore visualizza una finestra di dialogo che consente la selezione di un certificato da un archivio specificato.

Sintassi

PCCERT_CONTEXT CryptUIDlgSelectCertificateFromStore(
  [in]           HCERTSTORE hCertStore,
  [in]           HWND       hwnd,
  [in, optional] LPCWSTR    pwszTitle,
  [in, optional] LPCWSTR    pwszDisplayString,
  [in]           DWORD      dwDontUseColumn,
  [in]           DWORD      dwFlags,
  [in]           void       *pvReserved
);

Parametri

[in] hCertStore

Handle dell'archivio certificati da cercare.

[in] hwnd

Handle della finestra per la visualizzazione. Se NULL, per impostazione predefinita viene visualizzata la finestra desktop.

[in, optional] pwszTitle

Stringa utilizzata come titolo della finestra di dialogo. Se NULL, viene usato il titolo predefinito "Seleziona certificato".

[in, optional] pwszDisplayString

Istruzione di testo nella finestra di dialogo di selezione. Se NULL, viene usata la frase predefinita "Selezionare un certificato da usare".

[in] dwDontUseColumn

Flag che possono essere combinati per escludere colonne della visualizzazione.

Valore	Significato
CRYPTUI_SELECT_ISSUEDTO_COLUMN	Non visualizzare le informazioni ISSUEDTO.
CRYPTUI_SELECT_ISSUEDBY_COLUMN	Non visualizzare le informazioni ISSUEDBY.
CRYPTUI_SELECT_INTENDEDUSE_COLUMN	Non visualizzare le informazioni IntendedUse.
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN	Non visualizzare le informazioni sul nome visualizzato.
CRYPTUI_SELECT_LOCATION_COLUMN	Non visualizzare le informazioni sulla posizione.
CRYPTUI_SELECT_EXPIRATION_COLUMN	Non visualizzare le informazioni sulla scadenza.

[in] dwFlags

Attualmente non usato e deve essere impostato su 0.

[in] pvReserved

Riservato per utilizzi futuri.

Valore restituito

Restituisce un puntatore al contesto del certificato selezionato. Se non è stato selezionato alcun certificato, viene restituito NULL . Al termine dell'uso del certificato, liberare il contesto del certificato chiamando la funzione CertFreeCertificateContext .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	cryptuiapi.h
Libreria	Cryptui.lib
DLL	Cryptui.dll

Vedi anche

CryptUIDlgViewContext