Compartir a través de

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

  • Artículo

El método GetConfigEntry recupera información de configuración de una entidad de certificación (CA).

Sintaxis

HRESULT GetConfigEntry(
  [in]  const BSTR strConfig,
  [in]  const BSTR strNodePath,
  [in]  const BSTR strEntryName,
  [out] 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 recupera información de configuración que no es específica de una entidad de certificación. Este parámetro no puede ser NULL.

ImportanteGetConfigEntry no borra la 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 está recuperando. Este valor puede ser una cadena vacía, en cuyo caso se recuperan todos los nombres de entrada. Este parámetro no puede ser NULL.

[out] pvarEntry

Puntero a un variant que recibe la información solicitada.

Valor devuelto

C++

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.

VB

El valor devuelto es un valor Variant que representa la información de configuración recuperada.

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

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 certadm.h (incluya Certsrv.h)
Library Certidl.lib
Archivo DLL Certadm.dll

Consulte también

ICertAdmin2