IOCSPAdmin::SetConfiguration-Methode (certadm.h)
Die SetConfiguration-Methode aktualisiert einen Antwortdienst mit Konfigurationsänderungen.
Syntax
HRESULT SetConfiguration(
[in] const BSTR bstrServerName,
[in] VARIANT_BOOL bForce
);
Parameter
[in] bstrServerName
Eine Zeichenfolge, die den Namen des Antwortgeber-Diensts enthält.
[in] bForce
| C++ | VARIANT_TRUE , ob die Methode die Registrierung des Antwortdiensts aktualisieren soll, wenn der Dienst offline ist oder nicht verfügbar ist; andernfalls VARIANT_FALSE. Wenn der Dienst offline oder nicht verfügbar ist und der bForce-ParameterVARIANT_TRUE ist, aktualisiert SetConfiguration die Registrierung des Antwortdiensts direkt. |
| VB | True , wenn die Methode die Registrierung des Antwortdiensts aktualisieren soll, wenn der Dienst offline ist oder nicht verfügbar ist; andernfalls False. Wenn der Dienst offline oder nicht verfügbar ist und der bForce-ParameterTrue ist, aktualisiert SetConfiguration die Registrierung des Antwortdiensts direkt. |
Rückgabewert
VB
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück.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.
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. |
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 |