ICertAdmin2::SetConfigEntry-Methode (certadm.h)

Artikel
08/22/2023

Die SetConfigEntry-Methode legt Konfigurationsinformationen für eine Zertifizierungsstelle fest.

Syntax

HRESULT SetConfigEntry(
  [in] const BSTR strConfig,
  [in] const BSTR strNodePath,
  [in] const BSTR strEntryName,
  [in] VARIANT    *pvarEntry
);

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 des Setups der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig. Bei diesem Parameter kann es sich um eine leere Zeichenfolge handeln. In diesem Fall legt die Funktion Konfigurationsinformationen fest, die nicht spezifisch für eine Zertifizierungsstelle sind. Dieser Parameter darf nicht NULL sein.

WichtigSetConfigEntry 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 mit der neuen Konfigurationszeichenfolge erneut aufrufen.

[in] strNodePath

Zeichenfolgenwert, der den Knotenpfad für die Konfigurationsinformationen darstellt. Dieser Parameter kann eine leere Zeichenfolge sein. In diesem Fall ruft die Funktion Konfigurationsinformationen aus dem durch strConfig identifizierten Pfad ab. Dieser Parameter darf nicht NULL sein.

[in] strEntryName

Zeichenfolgenwert, der den Namen des Eintrags darstellt, dessen Informationen festgelegt werden. Dieser Wert kann eine leere Zeichenfolge sein. In diesem Fall ist der Standardeintrag der festgelegte Eintrag. Dieser Parameter darf nicht NULL sein.

[in] pvarEntry

C++	Zeiger auf VARIANT , der die festzulegenden Informationen angibt. Wenn dieser Wert leer ist, wird der angegebene Schlüssel gelöscht.
VB	Variante , die die festzulegenden Informationen angibt. Wenn dieser Wert leer ist, wird der angegebene Schlüssel gelöscht.

Rückgabewert

VB

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein HRESULT , das den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Die Konfigurationsinformationen werden in der Registrierung unter dem folgenden Pfad gespeichert.

HKEY_LOCAL_MACHINE\SYSTEM\Currentcontrolset\Dienstleistungen\CertSvc\Konfiguration\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

Wobei CASANITIZEDNAME der sanitisierte Name für die Zertifizierungsstelle ist. Weitere Informationen zu sanitisierten Namen finden Sie unter ICertConfig2::GetConfig.

Anforderungen


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