Método ICertAdmin2::SetConfigEntry (certadm.h)

  • Artículo

El método SetConfigEntry establece información de configuración para una entidad de certificación (CA).

Sintaxis

HRESULT SetConfigEntry(
  [in] const BSTR strConfig,
  [in] const BSTR strNodePath,
  [in] const BSTR strEntryName,
  [in] VARIANT    *pvarEntry
);

Parámetros

[in] strConfig

Valor de cadena que representa una cadena de configuración válida para la ENTIDAD de certificación 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, tal como se escribió durante la instalación de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig. Este parámetro puede ser una cadena vacía, en cuyo caso la función establece información de configuración que no es específica de una entidad de certificación. Este parámetro no puede ser NULL.

ImportanteSetConfigEntry no borra la memoria caché interna cuando se cambia la cadena de configuración. Al cambiar la cadena de configuración de la ENTIDAD de certificación, debe crear una instancia de un nuevo objeto ICertAdmin y llamar a este método de nuevo con la nueva cadena de configuración.
 

[in] strNodePath

Valor de cadena que representa la ruta de acceso del nodo para la información de configuración. Este parámetro puede ser una cadena vacía, en cuyo caso la función recupera información de configuración de la ruta de acceso identificada por strConfig. Este parámetro no puede ser NULL.

[in] strEntryName

Valor de cadena que representa el nombre de la entrada cuya información se va a establecer. Este valor puede ser una cadena vacía, en cuyo caso la entrada predeterminada es la entrada que se establece. Este parámetro no puede ser NULL.

[in] pvarEntry

C++ Puntero a VARIANT que especifica la información que se va a establecer. Si este valor está vacío, se eliminará la clave indicada.
VB Variant que especifica la información que se va a establecer. Si este valor está vacío, se eliminará la clave indicada.

Valor devuelto

VB

Si la función se ejecuta correctamente, el valor devuelto se S_OK.

Si se produce un error en la función, el valor devuelto es un VALOR HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

La información de configuración se almacena en el Registro en la siguiente ruta de acceso.

HKEY_LOCAL_MACHINE\SISTEMA\Currentcontrolset\Servicios\CertSvc\Configuración\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

Donde CASANITIZEDNAME es el nombre saneado de la ENTIDAD de certificación. Para obtener más información sobre los nombres saneados, vea ICertConfig2::GetConfig.

Requisitos

   
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certadm.h (incluya Certsrv.h)
Library Certidl.lib
Archivo DLL Certadm.dll

Consulte también

ICertAdmin2