ICertAdmin2::ImportKey-Methode (certadm.h)

Artikel
02/28/2024

Die ImportKey-Methode fügt einem Element in der Zertifikatdienste-Datenbank einen verschlüsselten Schlüsselsatz hinzu. Der Schlüsselsatz wird mit einem oder mehreren Schlüsselwiederherstellungs-Agent-Zertifikaten (KRA) verschlüsselt.

Syntax

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

Parameter

[in] strConfig

Zeichenfolgenwert, der eine gültige Konfigurationszeichenfolge für die Zertifizierungsstelle im Format COMPUTERNAME\CANAME darstellt, wobei COMPUTERNAME der Netzwerkname des Zertifikatdiensteservers und CANAME der allgemeine Name der Zertifizierungsstelle ist, wie er während der Einrichtung der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

WichtigImportKey löscht den internen Cache nicht, wenn die Konfigurationszeichenfolge geändert wird. Wenn Sie die Konfigurationszeichenfolge für die Zertifizierungsstelle ändern, müssen Sie ein neues ICertAdmin-Objekt instanziieren und diese Methode erneut mit der neuen Konfigurationszeichenfolge aufrufen.

[in] RequestId

LONG-Wert , der die Zertifikatanforderungs-ID in der Zertifikatdienste-Datenbank darstellt. Wenn die Seriennummer (als strCertHash übergeben) anstelle der Anforderungs-ID verwendet werden soll, verwenden Sie null für diesen Wert.

[in] strCertHash

Zeichenfolgenwert, der den Zertifikathash darstellt. Damit strCertHash verwendet werden kann, müssen Sie für RequestId den Wert 0 (null) angeben.

[in] Flags

Gibt das Format des Schlüssels an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
CR_IN_BASE64HEADER	BASE64-Format mit Anfang oder Ende.
CR_IN_BASE64	BASE64-Format ohne Anfang oder Ende.
CR_IN_BINARY	Binärformat.

Darüber hinaus kann der folgende Wert mithilfe einer bitweisen OR-Operation mit dem Formatwert kombiniert werden.

Wert	Bedeutung
IKF_OVERWRITE	Alle vorhandenen KRA-codierten Informationen werden überschrieben.

[in] strKey

Zeichenfolgenwert, der die KRA-Schlüsselinformationen darstellt.

Rückgabewert

Keine

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certadm.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certadm.dll

Weitere Informationen

ICertAdmin2

Freigeben über