Share via

ICertManageModule::Configure-Methode (certmod.h)

  • Artikel

Die Configure-Methode zeigt die Benutzeroberfläche des Moduls an.

Syntax

HRESULT Configure(
  [in] const BSTR strConfig,
  [in] BSTR       strStorageLocation,
  [in] LONG       Flags
);

Parameter

[in] strConfig

Stellt die Konfigurationszeichenfolge für den Zertifikatdiensteserver im Format COMPUTERNAME\CANAME dar, wobei COMPUTERNAME der Netzwerkname des Zertifikatdiensteservers und CANAME der allgemeine Name der Zertifizierungsstelle ist, wie er während der Einrichtung der Zertifikatdienste für die Zertifizierungsstelle eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

[in] strStorageLocation

Ein Speicherort, der Speicher für die Eigenschaftswerte bereitstellt, wie in der Definition von strStorageLocation in ICertManageModule::GetProperty beschrieben.

[in] Flags

Ein Wert, mit dem bestimmt wird, ob die Konfigurationsschnittstelle dem Benutzer angezeigt werden soll. Wenn dieser Wert null ist, wird dem Benutzer eine Schnittstelle zum Konfigurieren des Moduls angezeigt. Wenn dieser Wert CMM_REFRESHONLY ist, wird die Benutzeroberfläche von Zertifikatdiensten nicht angezeigt, aber die neuesten Änderungen an der Konfiguration des Moduls werden wirksam, wenn zukünftige Zertifikatanforderungen verarbeitet werden (dies ermöglicht die Einbindung von Änderungen, ohne dass eine Antwort auf eine Benutzeroberfläche erforderlich ist).

Rückgabewert

VB

Wenn die Methode erfolgreich ist, gibt die Methode 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

Die Configure-Methode zeigt die Modul-Benutzeroberfläche an (sofern vorhanden), mit der der Benutzer die konfigurierbaren Elemente des Moduls anzeigen und ändern kann. Für ein Modul, das ICertManageModule implementiert, kann die Configure-Methode aufgerufen werden, wenn die Eigenschaftenseite Zertifikatdienste-Manager-Richtlinie oder Exit Module aktiv ist und der Benutzer die Schaltfläche Konfigurieren auswäht. Der Zertifikatdienste-Manager übergibt den Speicherort, auf den strStorageLocation verweist, an dieses Modul, und die Implementierung dieser Methode kann diesen Speicherort dann bei Bedarf verwenden. Beachten Sie, dass es möglich ist, dass ein Modul möglicherweise keine konfigurierbaren Elemente enthält (daher wäre eine Benutzeroberfläche nicht erforderlich), aber es wäre trotzdem erforderlich, diese Methode zu implementieren. Im folgenden Beispiel kann ein Benutzer keine Konfigurationsänderung vornehmen, aber es implementiert diese Methode.

Beispiele

#include <windows.h>
#include <Certmod.h>

HRESULT CCertManagePolicyModule::Configure( 
            /* [in] */ const BSTR strConfig,
            /* [in] */ BSTR strStorageLocation,
            /* [in] */ LONG Flags)
{
    if ( CMM_REFRESHONLY != Flags )
        MessageBox(NULL,
                   L"This module has no configurable items",
                   L"MyModule",
                   (MB_OK|MB_ICONINFORMATION));

    return S_OK;
}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile certmod.h (include Certsrv.h)
Bibliothek Certidl.lib

Weitere Informationen

ICertConfig

ICertManageModule