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

Artículo
08/22/2023

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

Compartir a través de