Método ICertManageModule::Configure (certmod.h)

El método Configure muestra la interfaz de usuario del módulo.

Sintaxis

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

Parámetros

[in] strConfig

Representa la cadena de configuración del servidor de Servicios de certificados con el formato COMPUTERNAME\CANAME, donde COMPUTERNAME es el nombre de red del servidor de Servicios de certificados y CANAME es el nombre común de la entidad de certificación (CA) tal como se especifica para la CA durante la instalación de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig.

[in] strStorageLocation

Ubicación que proporciona almacenamiento para los valores de propiedad, como se describe en la definición de strStorageLocation en ICertManageModule::GetProperty.

[in] Flags

Valor que se usa para determinar si la interfaz de configuración se va a presentar al usuario. Si este valor es cero, se le presentará al usuario una interfaz para configurar el módulo. Si este valor es CMM_REFRESHONLY, Servicios de certificados no mostrará la interfaz de usuario, pero los cambios más recientes en la configuración del módulo estarán en vigor cuando se procesen futuras solicitudes de certificado (esto permite incorporar los cambios sin necesidad de una respuesta a una interfaz de usuario).

Valor devuelto

VB

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

El método Configure muestra la interfaz de usuario del módulo (si existe), lo que permite al usuario ver y cambiar los elementos configurables del módulo. Un módulo que implementa ICertManageModule puede llamar a su método Configure cuando la página de propiedades Directiva del Administrador de servicios de certificados o Módulo de salida está activa y el usuario elige el botón Configurar . El Administrador de servicios de certificados pasará la ubicación a la que hace referencia strStorageLocation a este módulo y, a continuación, la implementación de este método puede usar esta ubicación según sea necesario. Tenga en cuenta que es posible que un módulo no tenga elementos configurables (por lo tanto, no sería necesaria una interfaz de usuario), pero aún sería necesario implementar este método. En el ejemplo siguiente no se permite que un usuario realice un cambio de configuración, pero implementa este método.

Ejemplos

#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;
}

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certmod.h (incluye Certsrv.h)
Library	Certidl.lib

Consulte también

ICertConfig

ICertManageModule