Funzione CryptUIWizImport (cryptuiapi.h)

Articolo
02/26/2024

La funzione importa un certificato, un elenco di attendibilità certificato (CTL), un elenco di revoche di certificati (CRL) o un archivio certificati in un archivio certificati. L'importazione può essere eseguita con o senza interazione utente.

Sintassi

BOOL CryptUIWizImport(
  [in] DWORD                         dwFlags,
  [in] HWND                          hwndParent,
  [in] LPCWSTR                       pwszWizardTitle,
  [in] PCCRYPTUI_WIZ_IMPORT_SRC_INFO pImportSrc,
  [in] HCERTSTORE                    hDestCertStore
);

Parametri

[in] dwFlags

Contiene flag che modificano il comportamento della funzione. Questo può essere zero o una combinazione di uno o più dei valori seguenti.

Nota Ad eccezione di CRYPTUI_WIZ_NO_UI, nessuna delle costanti seguenti viene definita in un file di intestazione pubblicato. Per usare queste costanti, è necessario definirle usando i valori specificati.

Valore	Significato
CRYPTUI_WIZ_NO_UI 0x0001	Questa funzione eseguirà l'importazione in base alle informazioni nella struttura CRYPTUI_WIZ_IMPORT_SRC_INFO puntata da pImportSrc nell'archivio specificato da hDestCertStore senza visualizzare alcuna interfaccia utente. Se questo flag non è specificato, questa funzione visualizzerà una procedura guidata per guidare l'utente attraverso il processo di importazione. A partire da Windows 8 e Windows Server 2012, se si imposta questo flag e si importa un certificato da un BLOB PFX protetto in un'entità Active Directory (AD) e l'utente corrente, come parte di tale entità, ha l'autorizzazione per decrittografare la password incorporata nel pacchetto PFX, l'importazione avrà esito positivo senza richiedere che una password venga impostata nella CRYPTUI_WIZ_IMPORT_SRC_INFO Struttura. Per altre informazioni sulla protezione di PFX in un'entità AD, vedere il parametro pvPara e il flag PKCS12_PROTECT_TO_DOMAIN_SIDS della funzione PFXExportCertStoreEx .
CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS 0x0002	Eliminare tutte le interfacce utente generate dai provider di servizi di crittografia . Questa opzione può essere sostituita dall'opzione CRYPTUI_WIZ_NO_UI_EXCEPT_CSP .
CRYPTUI_WIZ_NO_UI_EXCEPT_CSP 0x0003	Eliminare tutte le interfacce utente, ad eccezione di quelle generate dai provider di servizi di configurazione. Questa opzione esegue l'override dell'opzione CRYPTUI_WIZ_IGNORE_NO_UI_FLAG_FOR_CSPS .
CRYPTUI_WIZ_IMPORT_ALLOW_CERT 0x00020000	Consentire l'importazione dei certificati.
CRYPTUI_WIZ_IMPORT_ALLOW_CRL 0x00040000	Consenti l'importazione di CCL.
CRYPTUI_WIZ_IMPORT_ALLOW_CTL 0x00080000	Consenti l'importazione di ELENCHI di controllo di accesso.
CRYPTUI_WIZ_IMPORT_NO_CHANGE_DEST_STORE 0x00010000	Non consentire all'utente di modificare l'archivio certificati di destinazione rappresentato dal parametro hDestCertStore .
CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE 0x00100000	Importare l'oggetto nell'archivio certificati per il computer locale. Questo vale solo per le importazioni PFX (Personal Information Exchange).
CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER 0x00200000	Importare l'oggetto nell'archivio certificati per l'utente corrente. Questo vale solo per le importazioni PFX.
CRYPTUI_WIZ_IMPORT_REMOTE_DEST_STORE 0x00400000	Importare l'oggetto in un archivio certificati remoto. Impostare questo flag se il parametro hDestCertStore rappresenta un archivio certificati remoto.

[in] hwndParent

Handle della finestra da usare come padre della finestra di dialogo creata da questa funzione. Questo parametro viene ignorato se il flag di CRYPTUI_WIZ_NO_UI è impostato in dwFlags.

[in] pwszWizardTitle

Puntatore a una stringa Unicode con terminazione null contenente il titolo da usare nella finestra di dialogo creata da questa funzione. Questo parametro viene ignorato se il flag di CRYPTUI_WIZ_NO_UI è impostato in dwFlags.

[in] pImportSrc

Puntatore a una struttura CRYPTUI_WIZ_IMPORT_SRC_INFO che contiene informazioni sull'oggetto da importare. Questo parametro è obbligatorio se CRYPTUI_WIZ_NO_UI è impostato in dwFlags ed è facoltativo in caso contrario.

[in] hDestCertStore

Handle dell'archivio certificati da importare. Se questo parametro è NULL e il flag di CRYPTUI_WIZ_NO_UI non è impostato in dwFlags, la procedura guidata richiederà all'utente di selezionare un archivio certificati.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per informazioni sull'errore estese, chiamare la funzione GetLastError .

Commenti

Se nessuno dei tre flag seguenti è impostato in dwFlags, l'importazione di qualsiasi tipo di contenuto è consentita:

CRYPTUI_WIZ_IMPORT_ALLOW_CERT
CRYPTUI_WIZ_IMPORT_ALLOW_CRL
CRYPTUI_WIZ_IMPORT_ALLOW_CTL

I flag di CRYPTUI_WIZ_IMPORT_TO_LOCALMACHINE e CRYPTUI_WIZ_IMPORT_TO_CURRENTUSER vengono usati per forzare il contenuto di un BLOB PFX nell'archivio computer locale o nell'archivio utenti corrente. Se nessuno di questi flag è impostato e hDestCertStore è NULL:

La chiave privata nel BLOB PFX verrà costretta a essere importata nell'archivio utenti corrente.
Se CRYPTUI_WIZ_NO_UI non è impostato, la procedura guidata richiede all'utente di selezionare un archivio certificati tra gli archivi certificati utente correnti.

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

CRYPTUI_WIZ_IMPORT_SRC_INFO

CryptUIWizExport

Condividi tramite