Funzione CryptUIWizImport (cryptuiapi.h)

  • Articolo

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