ICertManageModule::Configure-Methode (certmod.h)
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 |