Función CryptImportPublicKeyInfoEx2 (wincrypt.h)

  • Artículo

La función CryptImportPublicKeyInfoEx2 importa una clave pública en el proveedor asimétrico CNG que corresponde al identificador de objeto de clave pública (OID) y devuelve un identificador CNG a la clave.

Sintaxis

BOOL CryptImportPublicKeyInfoEx2(
  [in]  DWORD                 dwCertEncodingType,
  [in]  PCERT_PUBLIC_KEY_INFO pInfo,
  [in]  DWORD                 dwFlags,
  [in]  void                  *pvAuxInfo,
  [out] BCRYPT_KEY_HANDLE     *phKey
);

Parámetros

[in] dwCertEncodingType

Tipo de codificación de certificado que se usó para cifrar el asunto. Esta función omite el identificador de tipo de codificación de mensaje , contenido en la palabra alta de este valor.

Este parámetro puede ser el siguiente tipo de codificación de certificado definido actualmente.

Value Significado
X509_ASN_ENCODING
1 (0x1)
 Especifica la codificación de certificados X.509 .

[in] pInfo

Dirección de una estructura de CERT_PUBLIC_KEY_INFO que contiene la información de clave pública que se va a importar en el proveedor.

[in] dwFlags

Conjunto de marcas que modifican el comportamiento de esta función. Puede ser cero o una combinación de uno o varios de los valores siguientes.

Value Significado
CRYPT_OID_INFO_PUBKEY_SIGN_KEY_FLAG
 Omite las claves públicas del grupo CRYPT_PUBKEY_ALG_OID_GROUP_ID que se marcan explícitamente con la marca CRYPT_OID_PUBKEY_ENCRYPT_ONLY_FLAG.
CRYPT_OID_INFO_PUBKEY_ENCRYPT_KEY_FLAG
 Omite las claves públicas del grupo CRYPT_PUBKEY_ALG_OID_GROUP_ID que se marcan explícitamente con la marca CRYPT_OID_PUBKEY_SIGN_ONLY_FLAG.
 

Estas marcas se pasan en el parámetro dwKeyType de la función CryptFindOIDInfo al asignar el identificador de objeto de clave pública al identificador de algoritmo de clave pública CNG correspondiente.

[in] pvAuxInfo

Este parámetro está reservado para uso futuro y debe establecerse en NULL.

[out] phKey

Dirección de una variable BCRYPT_KEY_HANDLE que recibe el identificador de la clave importada.

Cuando este identificador ya no sea necesario, debe liberarlo llamando a la función BCryptDestroyKey .

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero (TRUE).

Si se produce un error en la función, devuelve cero (FALSE). Para obtener información de error extendida, llame a GetLastError. Entre los posibles códigos de error se incluyen, entre otros, los siguientes.

Código devuelto Descripción
ERROR_FILE_NOT_FOUND
 No se encontró una función de importación que se puede instalar o registrar para los parámetros dwCertEncodingType y pInfo especificados.
E_INVALIDARG
 Uno o más parámetros no son válidos.

Requisitos

   
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado wincrypt.h
Library Crypt32.lib
Archivo DLL Crypt32.dll

Consulte también

CERT_PUBLIC_KEY_INFO