Metodo ICertAdmin2::ImportKey (certadm.h)

  • Articolo

Il metodo ImportKey aggiunge un set di chiavi crittografato a un elemento nel database di Servizi certificati. Il set di chiavi viene crittografato in uno o più certificati dell'agente di ripristino delle chiavi (KRA).

Sintassi

HRESULT ImportKey(
  [in] const BSTR strConfig,
  [in] LONG       RequestId,
  [in] const BSTR strCertHash,
  [in] LONG       Flags,
  [in] const BSTR strKey
);

Parametri

[in] strConfig

Valore stringa che rappresenta una stringa di configurazione valida per l'autorità di certificazione (CA) nel formato COMPUTERNAME\CANAME, dove COMPUTERNAME è il nome di rete del server di Servizi certificati e CANAME è il nome comune della CA, come immesso durante l'installazione di Servizi certificati. Per informazioni sul nome della stringa di configurazione, vedere ICertConfig.

ImportaKey importante non cancella la cache interna quando viene modificata la stringa di configurazione. Quando si modifica la stringa di configurazione per la CA, è necessario creare un'istanza di un nuovo oggetto ICertAdmin e chiamare di nuovo questo metodo con la nuova stringa di configurazione.
 

[in] RequestId

Valore LONG che rappresenta l'ID richiesta di certificato nel database Di Servizi certificati. Se il numero di serie (passato come strCertHash) deve essere usato anziché l'ID richiesta, usare zero per questo valore.

[in] strCertHash

Valore stringa che rappresenta l'hash del certificato. Per usare strCertHash , è necessario specificare un valore pari a zero per RequestId.

[in] Flags

Specifica il formato della chiave. Questo parametro può avere uno dei valori seguenti.

Valore Significato
CR_IN_BASE64HEADER
 Formato BASE64 con inizio o fine.
CR_IN_BASE64
 Formato BASE64 senza inizio o fine.
CR_IN_BINARY
 Formato binario.
 

Inoltre, il valore seguente può essere combinato con il valore di formato usando un'operazione BIT-OR .

Valore Significato
IKF_OVERWRITE
 Tutte le informazioni con codifica KRA esistenti vengono sovrascritte.

[in] strKey

Valore stringa che rappresenta le informazioni sulla chiave KRA.

Valore restituito

nessuno

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione certadm.h (include Certsrv.h)
Libreria Certidl.lib
DLL Certadm.dll

Vedi anche

ICertAdmin2