Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die GetConfiguration-Methode stellt eine Verbindung mit einem OCSP-Antwortserver (Online Certificate Status Protocol) her und initialisiert ein OCSPAdmin-Objekt mit den Konfigurationsinformationen vom Server.
Syntax
HRESULT GetConfiguration(
[in] const BSTR bstrServerName,
[in] VARIANT_BOOL bForce
);
Parameter
[in] bstrServerName
Eine Zeichenfolge, die den Namen des Antwortservers enthält.
[in] bForce
| C++ | VARIANT_TRUE, wenn der Aufrufer die Antwortkonfiguration aus der Registrierung des Servers lesen möchte, wenn eine ausgeführte instance des OCSP-Antwortdiensts nicht gefunden werden kann, andernfalls VARIANT_FALSE. |
| VB | True, wenn der Aufrufer die Antwortkonfiguration aus der Registrierung des Servers lesen möchte, wenn ein ausgeführter instance des OCSP-Antwortdiensts nicht gefunden werden kann, andernfalls False. |
Rückgabewert
VB
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben.Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
Wenn die Methode HRESULT_FROM_WIN32(ERROR_INVALID_STATE) zurückgibt, ist die Konfiguration bereits initialisiert.
Wenn die Methode E_INVALIDARG zurückgibt, wurde der pVal-Parameter auf NULL festgelegt.
Hinweise
In der folgenden Tabelle sind die Auswirkungen des bForce-Parameterwerts auf den Methodenaufruf aufgeführt.
| OCSP-Antwortdienst auf dem Zielserver | bForce ist VARIANT_TRUE | bForce ist VARIANT_FALSE |
|---|---|---|
| Wird ausgeführt | Rufen Sie die Konfiguration aus dem Dienst ab. | Rufen Sie die Konfiguration aus dem Dienst ab. |
| Beendet | Versuchen Sie, die Konfiguration aus der Serverregistrierung abzurufen. Wenn dieser Versuch fehlschlägt, geben Sie einen Fehler zurück. | Gibt einen Fehler zurück. |
In der folgenden Tabelle sind die Auswirkungen des bForce-Parameterwerts auf den Methodenaufruf aufgeführt.
| OCSP-Antwortdienst auf dem Zielserver | bForce ist true | bForce ist False. |
|---|---|---|
| Wird ausgeführt | Rufen Sie die Konfiguration aus dem Dienst ab. | Rufen Sie die Konfiguration aus dem Dienst ab. |
| Beendet | Versuchen Sie, die Konfiguration aus der Serverregistrierung abzurufen. Wenn dieser Versuch fehlschlägt, geben Sie einen Fehler zurück. | Gibt einen Fehler zurück. |
Diese Methode versucht, die Konfiguration aus einem ausgeführten instance eines OCSP-Antwortdiensts zu lesen. Dies ist jedoch möglicherweise nicht möglich, wenn der Dienst nicht ausgeführt wird oder sich in einem nicht zugänglichen Zustand befindet. Der Aufrufer kann die -Methode anweisen, die Konfiguration aus der Registrierung des Servers zu lesen, wenn ein ausgeführter instance nicht gefunden werden kann.
Die -Methode schlägt fehl, wenn Sie versuchen, sie für ein bestimmtes OCSPAdmin-Objekt mehrmals aufzurufen. Jede instance von OCSPAdmin entspricht einem Antwortserver. Um eine Verbindung mit einem anderen Server in einem Array von OCSP-Antwortservern herzustellen, erstellen Sie eine neue instance eines OCSPAdmin-Objekts.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 Datacenter, Windows Server 2008 Enterprise [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | certadm.h (include Certsrv.h) |
| Bibliothek | Certadm.lib |
| DLL | Certadm.dll |