Función BCryptEnumProviders (bcrypt.h)

La función BCryptEnumProviders obtiene todos los proveedores de CNG que admiten un algoritmo especificado.

Sintaxis

NTSTATUS BCryptEnumProviders(
  [in]  LPCWSTR              pszAlgId,
  [out] ULONG                *pImplCount,
  [out] BCRYPT_PROVIDER_NAME **ppImplList,
  [in]  ULONG                dwFlags
);

Parámetros

[in] pszAlgId

Puntero a una cadena Unicode terminada en null que identifica el algoritmo para el que se obtienen los proveedores. Puede ser uno de los identificadores de algoritmo de CNG predefinidos u otro identificador de algoritmo.

[out] pImplCount

Puntero a una variable ULONG para recibir el número de elementos de la matriz ppImplList .

[out] ppImplList

Dirección de una matriz de estructuras de BCRYPT_PROVIDER_NAME para recibir la colección de proveedores que admiten el algoritmo especificado. El parámetro pImplCount recibe el número de elementos de esta matriz. Esta memoria debe liberarse cuando ya no sea necesaria pasando este puntero a la función BCryptFreeBuffer .

[in] dwFlags

Conjunto de marcas que modifica el comportamiento de esta función. Actualmente no hay marcas definidas, por lo que este parámetro debe ser cero.

Valor devuelto

Devuelve un código de estado que indica el éxito o error de la función.

Entre los códigos de retorno posibles se incluyen, entre otros, los siguientes.

Código devuelto	Descripción
STATUS_SUCCESS	La función se realizó correctamente.
STATUS_INVALID_PARAMETER	Uno o más parámetros no son válidos.
STATUS_NO_MEMORY	Error de asignación de memoria.

Comentarios

Se puede llamar a BCryptEnumProviders desde el modo de usuario o el modo kernel. Los autores de llamadas en modo kernel deben ejecutarse en PASSIVE_LEVELIRQL.

Requisitos

Requisito	Value
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	bcrypt.h
Library	Bcrypt.lib
Archivo DLL	Bcrypt.dll

Consulte también

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer