Metodo ICertAdmin2::ImportKey (certadm.h)

Articolo
03/14/2023

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

Condividi tramite