Función CryptGetDefaultOIDDllList (wincrypt.h)

  • Artículo

La función CryptGetDefaultOIDDllList adquiere la lista de los nombres de los archivos DLL que contienen funciones de identificador de objeto (OID) predeterminadas registradas para un conjunto de funciones y un tipo de codificación especificados.

Sintaxis

BOOL CryptGetDefaultOIDDllList(
  [in]      HCRYPTOIDFUNCSET hFuncSet,
  [in]      DWORD            dwEncodingType,
  [out]     WCHAR            *pwszDllList,
  [in, out] DWORD            *pcchDllList
);

Parámetros

[in] hFuncSet

Identificador del conjunto de funciones obtenido previamente por una llamada a CryptInitOIDFunctionSet.

[in] dwEncodingType

Especifica el tipo de codificación que se va a coincidir. Actualmente, solo se usan X509_ASN_ENCODING y PKCS_7_ASN_ENCODING; sin embargo, en el futuro se pueden agregar tipos de codificación adicionales. Para hacer coincidir ambos tipos de codificación actuales, use:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Nota Se requiere un tipo de codificación de certificado o mensaje . X509_ASN_ENCODING es el valor predeterminado. Si se indica ese tipo, se utiliza; de lo contrario, si se indica el tipo PKCS7_ASN_ENCODING, se usa.
 

[out] pwszDllList

Puntero a un búfer para recibir la lista de nombres de archivo terminados en null o más. La lista devuelta finaliza con un carácter NULL de terminación. Por ejemplo, una lista de dos nombres podría ser:

L"first.dll\0" L"second.dll\0" L"\0"

Para recuperar el número de caracteres anchos que debe contener el búfer, este parámetro puede ser NULL. Para obtener más información, vea Recuperación de datos de longitud desconocida.

[in, out] pcchDllList

Puntero a un DWORD que especifica el tamaño, en caracteres anchos, de la lista devuelta a la que apunta el parámetro pwszDllList . Cuando se devuelve la función, la variable a la que apunta el parámetro pcchDllList contiene el número de caracteres anchos almacenados en el búfer.

Nota Al procesar los datos devueltos en el búfer, las aplicaciones deben usar el tamaño real de los datos devueltos. El tamaño real puede ser ligeramente menor que el tamaño del búfer especificado en la entrada. En la entrada, los tamaños de búfer suelen especificarse lo suficientemente grandes como para asegurarse de que los datos de salida más grandes posibles caben en el búfer. En la salida, la variable a la que apunta este parámetro se actualiza para reflejar el tamaño real de los datos copiados en el búfer.
 

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.

Esta función tiene los siguientes códigos de error.

Código devuelto Descripción
ERROR_MORE_DATA
 Si el búfer especificado por el parámetro pwszDllList no es lo suficientemente grande como para contener los datos devueltos, la función establece el código ERROR_MORE_DATA y almacena el tamaño de búfer necesario, en caracteres anchos, en la variable a la que apunta pcchDllList.

Requisitos

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

Consulte también

Funciones de compatibilidad con OID