struttura CRYPTUI_WIZ_IMPORT_SRC_INFO (cryptuiapi.h)

  • Articolo

[La struttura CRYPTUI_WIZ_IMPORT_SRC_INFO è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

La struttura CRYPTUI_WIZ_IMPORT_SRC_INFO contiene l'oggetto da importare nella funzione CryptUIWizImport . L'oggetto può essere un certificato, un elenco di certificati attendibili (CTL) o un elenco di revoche di certificati (CRL).

Sintassi

typedef struct _CRYPTUI_WIZ_IMPORT_SUBJECT_INFO {
  DWORD   dwSize;
  DWORD   dwSubjectChoice;
  union {
    LPCWSTR        pwszFileName;
    PCCERT_CONTEXT pCertContext;
    PCCTL_CONTEXT  pCTLContext;
    PCCRL_CONTEXT  pCRLContext;
    HCERTSTORE     hCertStore;
  };
  DWORD   dwFlags;
  LPCWSTR pwszPassword;
} CRYPTUI_WIZ_IMPORT_SRC_INFO, *PCRYPTUI_WIZ_IMPORT_SRC_INFO;

Members

dwSize

Dimensione, in byte, della struttura.

dwSubjectChoice

Indica il tipo di oggetto da importare. Questo membro può essere uno dei valori seguenti.

Valore Significato
CRYPTUI_WIZ_IMPORT_SUBJECT_FILE
 Importare il certificato archiviato nel file a cui si fa riferimento nel membro pwszFileName .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT
 Importare il certificato a cui si fa riferimento nel membro pCertContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT
 Importare il CTL a cui si fa riferimento nel membro pCTLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT
 Importare il CRL a cui si fa riferimento nel membro pCRLContext .
CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE
 Importare l'archivio certificati a cui si fa riferimento nel membro hCertStore .

pwszFileName

Puntatore a una stringa Unicode con terminazione Null contenente il percorso e il nome file del file che contiene il certificato da importare. Questo membro viene utilizzato se il membro dwSubjectChoice contiene CRYPTUI_WIZ_IMPORT_SUBJECT_FILE.

pCertContext

Puntatore alla struttura CERT_CONTEXT che contiene il certificato da importare. Questo membro viene utilizzato se il membro dwSubjectChoice contiene CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_CONTEXT.

pCTLContext

Puntatore alla struttura CTL_CONTEXT che contiene il CTL da importare. Questo membro viene utilizzato se il membro dwSubjectChoice contiene CRYPTUI_WIZ_IMPORT_SUBJECT_CTL_CONTEXT.

pCRLContext

Puntatore alla struttura CRL_CONTEXT che contiene il CRL da importare. Questo membro viene utilizzato se il membro dwSubjectChoice contiene CRYPTUI_WIZ_IMPORT_SUBJECT_CRL_CONTEXT.

hCertStore

Handle per l'archivio certificati da importare. Questo membro viene utilizzato se il membro dwSubjectChoice contiene CRYPTUI_WIZ_IMPORT_SUBJECT_CERT_STORE.

dwFlags

Contiene flag che modificano l'operazione di importazione. Questo membro è obbligatorio se pwszFileName contiene un BLOB PFX (Personal Information Exchange). In caso contrario, questo membro viene ignorato. Questo membro può essere zero o una combinazione di uno o più dei valori seguenti.

Valore Significato
CRYPT_EXPORTABLE
 Le chiavi importate sono contrassegnate come esportabili. Se questo flag non viene usato, le chiamate alla funzione CryptExportKey hanno esito negativo.
CRYPT_USER_PROTECTED
 L'utente deve ricevere una notifica tramite una finestra di dialogo o un altro modo quando determinate azioni tentano di usare questa chiave. Il comportamento preciso viene specificato dal provider di servizi di crittografia (CSP) in uso.

Prima di Internet Explorer 4.0, i provider di servizi di configurazione Microsoft ignoravano questo flag. A partire da Internet Explorer 4.0, i provider di servizi di configurazione Microsoft supportano questo flag.

Se il contesto del provider è stato aperto con il flag CRYPT_SILENT impostato, l'uso di questo flag causa un errore e l'ultimo errore viene impostato su NTE_SILENT_CONTEXT.
CRYPT_MACHINE_KEYSET
 Le chiavi private vengono archiviate nel computer locale e non nell'utente corrente.
CRYPT_USER_KEYSET
 Le chiavi private vengono archiviate nell'utente corrente e non nel computer locale, anche se il BLOB PFX specifica che devono entrare nel computer locale.

pwszPassword

Puntatore a una stringa Unicode con terminazione Null contenente la password usata per accedere alla chiave privata. È necessaria una password se pwszFileName contiene un BLOB PFX. Se non è necessaria una password, la variabile può essere una stringa vuota. Questo membro non può essere NULL.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione cryptuiapi.h

Vedi anche

CRYPTUI_WIZ_EXPORT_INFO

CryptUIWizExport