IOCSPAdmin::GetConfiguration-Methode (certadm.h)
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 |