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 de para recibir el número de elementos de la matriz de 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 necesario 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 varios parámetros no son válidos.
STATUS_NO_MEMORY	Error de asignación de memoria.

Observaciones

se puede llamar a BCryptEnumProviders desde el modo de usuario o el modo kernel. Los llamadores de modo kernel deben ejecutarse en PASSIVE_LEVELIRQL.

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	bcrypt.h
biblioteca de	Bcrypt.lib
DLL de	Bcrypt.dll

Consulte también

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer