ICertManageModule ::Configure, méthode (certmod.h)
La méthode Configure affiche l’interface utilisateur du module.
Syntaxe
HRESULT Configure(
[in] const BSTR strConfig,
[in] BSTR strStorageLocation,
[in] LONG Flags
);
Paramètres
[in] strConfig
Représente la chaîne de configuration du serveur des services de certificats sous la forme COMPUTERNAME\CANAME, où COMPUTERNAME est le nom réseau du serveur des services de certificat et CANAME est le nom commun de l’autorité de certification (CA) telle qu’entrée pour l’autorité de certification lors de l’installation des services de certificat. Pour plus d’informations sur le nom de la chaîne de configuration, consultez ICertConfig.
[in] strStorageLocation
Emplacement qui fournit un stockage pour les valeurs de propriété, comme décrit dans la définition de strStorageLocation dans ICertManageModule ::GetProperty.
[in] Flags
Valeur utilisée pour déterminer si l’interface de configuration doit être présentée à l’utilisateur. Si cette valeur est égale à zéro, une interface pour configurer le module s’affiche à l’utilisateur. Si cette valeur est CMM_REFRESHONLY, les services de certificats n’affichent pas l’interface utilisateur, mais les dernières modifications apportées à la configuration du module seront en vigueur lors du traitement des futures demandes de certificat (cela permet d’incorporer les modifications sans nécessiter de réponse à une interface utilisateur).
Valeur retournée
VB
Si la méthode réussit, la méthode retourne S_OK.Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
Remarques
La méthode Configure affiche l’interface utilisateur du module (le cas échéant), ce qui permet à l’utilisateur d’afficher et de modifier les éléments configurables du module. La méthode Configure d’un module qui implémente ICertManageModule peut être appelée lorsque la page de propriétés Du gestionnaire des services de certificats ou du module de sortie est active et que l’utilisateur choisit le bouton Configurer. Le Gestionnaire des services de certificats transmet l’emplacement référencé par strStorageLocation à ce module, et l’implémentation de cette méthode peut ensuite utiliser cet emplacement si nécessaire. Notez qu’il est possible qu’un module n’ait pas d’éléments configurables (par conséquent, une interface utilisateur ne serait pas nécessaire), mais qu’il serait toujours nécessaire d’implémenter cette méthode. L’exemple ci-dessous n’autorise pas un utilisateur à apporter une modification de configuration, mais il implémente cette méthode.
Exemples
#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;
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | certmod.h (include Certsrv.h) |
| Bibliothèque | Certidl.lib |