ICertAdmin2::GetConfigEntry-Methode (certadm.h)

Artikel
02/23/2024

Die GetConfigEntry-Methode ruft Konfigurationsinformationen für eine Zertifizierungsstelle (Ca ) ab.

Syntax

HRESULT GetConfigEntry(
  [in]  const BSTR strConfig,
  [in]  const BSTR strNodePath,
  [in]  const BSTR strEntryName,
  [out] 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 der Einrichtung der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig. Dieser Parameter kann eine leere Zeichenfolge sein. In diesem Fall ruft die Funktion Konfigurationsinformationen ab, die nicht spezifisch für eine Zertifizierungsstelle sind. Dieser Parameter darf nicht NULL sein.

WichtigGetConfigEntry 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] 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 pfad ab, der durch strConfig identifiziert wird. Dieser Parameter darf nicht NULL sein.

[in] strEntryName

Zeichenfolgenwert, der den Namen des Eintrags darstellt, dessen Informationen abgerufen werden. Dieser Wert kann eine leere Zeichenfolge sein. In diesem Fall werden alle Eintragsnamen abgerufen. Dieser Parameter darf nicht NULL sein.

[out] pvarEntry

Ein Zeiger auf einen VARIANT-Wert , der die angeforderten Informationen empfängt.

Rückgabewert

C++

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.

VB

Der Rückgabewert ist ein Variant-Wert , der die abgerufenen Konfigurationsinformationen darstellt.

Hinweise

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

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

Dabei ist CASANITIZEDNAME der bereinigungslose Name für die Zertifizierungsstelle. Weitere Informationen zu bereinigungen Namen finden Sie unter ICertConfig2::GetConfig.

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