Ix509PrivateKey::Import (certenroll.h)

  • Artículo

El método Import importa una clave privada existente en un contenedor de claves dentro de un proveedor criptográfico.

Sintaxis

HRESULT Import(
  [in] BSTR         strExportType,
  [in] BSTR         strEncodedKey,
  [in] EncodingType Encoding
);

Parámetros

[in] strExportType

Si la clave se creó mediante un KSP de CNG (proveedor de almacenamiento de claves), el método Import pasa este argumento al parámetro pszProperty de la función NCryptSetProperty . Es decir, el valor que especifique se usará como nombre de una propiedad que se va a establecer en la clave importada.

Si la clave se creó mediante un CSP cryptoAPI (proveedor de servicios criptográficos), este argumento especifica cómo se importará la clave privada. Puede ser el siguiente valor.

Valor Significado
BCRYPT_PRIVATE_KEY_BLOB
 Importa toda la clave privada.

[in] strEncodedKey

Variable BSTR que contiene la clave que se va a importar.

[in] Encoding

Valor de enumeración EncodingType que especifica el tipo de codificación Unicode que se va a aplicar a la cadena contenida en el parámetro strEncodedKey . El valor predeterminado es XCN_CRYPT_STRING_BASE64.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código devuelto Descripción
HRESULT_FROM_WIN32(ERROR_FILE_READ_ONLY)
 El contenedor de claves ya está abierto. Puede recibir este error si ya ha llamado a Open o Create.
HRESULT_FROM_WIN32(ERROR_CALL_NOT_IMPLEMENTED)
 La clave se creó mediante un CSP de CryptoAPI y especificó un valor distinto de BCRYPT_PRIVATE_KEY_BLOB para el parámetro strExportType .

Comentarios

La función Import supone automáticamente que está intentando importar una clave KSP de CNG si especifica un valor distinto de BCRYPT_PRIVATE_KEY_BLOB para el parámetro strExportType y no establece ninguna de las siguientes propiedades:

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h
Archivo DLL CertEnroll.dll

Consulte también

IX509PrivateKey