Función CryptImportPublicKeyInfoEx2 (wincrypt.h)

La función CryptImportPublicKeyInfoEx2 importa una clave pública en el proveedor asimétrico CNG que corresponde a la clave pública identificador de objeto (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

El tipo de codificación de certificado que se usó para cifrar el asunto. La tipo de codificación de mensajes identificador, contenida en el alto word de este valor, esta función omite.

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

Valor	Significado
X509_ASN_ENCODING 1 (0x1)	Especifica 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.

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

 

Estas marcas se pasan en el parámetro dwKeyType del CryptFindOIDInfo función al asignar el identificador de objeto de clave pública al identificador de algoritmo de clave pública de 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 códigos de error posibles 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 especificados y pInfo.
E_INVALIDARG	Uno o varios parámetros no son válidos.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	wincrypt.h
biblioteca de	Crypt32.lib
DLL de	Crypt32.dll

Consulte también

CERT_PUBLIC_KEY_INFO