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

  • Artículo

El método ImportKey agrega una clave cifrada establecida a un elemento de la base de datos de Servicios de certificados. El conjunto de claves se cifra en uno o varios certificados de agente de recuperación de claves (KRA).

Sintaxis

HRESULT ImportKey(
  [in] const BSTR strConfig,
  [in] LONG       RequestId,
  [in] const BSTR strCertHash,
  [in] LONG       Flags,
  [in] const BSTR strKey
);

Parámetros

[in] strConfig

Valor de cadena que representa una cadena de configuración válida para la entidad de certificación (CA) 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 especifica durante la configuración de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig.

ImportanteImportKey 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] RequestId

Valor LONG que representa el identificador de solicitud de certificado en la base de datos de Servicios de certificados. Si el número de serie (pasado como strCertHash) se va a usar en lugar del identificador de solicitud, use cero para este valor.

[in] strCertHash

Valor de cadena que representa el hash del certificado. Para que se use strCertHash , debe especificar un valor de cero para RequestId.

[in] Flags

Especifica el formato de la clave. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
CR_IN_BASE64HEADER
 Formato BASE64 con begin o end.
CR_IN_BASE64
 Formato BASE64 sin comienzo o fin.
CR_IN_BINARY
 Formato binario.
 

Además, el siguiente valor se puede combinar con el valor de formato mediante una operación OR bit a bit.

Valor Significado
IKF_OVERWRITE
 Se sobrescribe cualquier información codificada en KRA existente.

[in] strKey

Valor de cadena que representa la información de clave KRA.

Valor devuelto

None

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