Função BCryptEnumProviders (bcrypt.h)

A função BCryptEnumProviders obtém todos os provedores CNG que dão suporte a um algoritmo especificado.

Sintaxe

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

Parâmetros

[in] pszAlgId

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que identifica o algoritmo para o qual obter os provedores. Esse pode ser um dos Identificadores de Algoritmo CNG predefinidos ou outro identificador de algoritmo.

[out] pImplCount

Um ponteiro para uma variável ULONG para receber o número de elementos na matriz ppImplList .

[out] ppImplList

O endereço de uma matriz de estruturas BCRYPT_PROVIDER_NAME para receber a coleção de provedores que dão suporte ao algoritmo especificado. O parâmetro pImplCount recebe o número de elementos nessa matriz. Essa memória deve ser liberada quando não for mais necessária passando esse ponteiro para a função BCryptFreeBuffer .

[in] dwFlags

Um conjunto de sinalizadores que modifica o comportamento dessa função. Atualmente, não há sinalizadores definidos, portanto, esse parâmetro deve ser zero.

Retornar valor

Retorna um código status que indica o êxito ou a falha da função.

Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno	Descrição
STATUS_SUCCESS	A função foi bem-sucedida.
STATUS_INVALID_PARAMETER	Um ou mais dos parâmetros não são válidos.
STATUS_NO_MEMORY	Ocorreu uma falha de alocação de memória.

Comentários

BCryptEnumProviders pode ser chamado do modo de usuário ou do modo kernel. Os chamadores do modo kernel devem estar em execução no PASSIVE_LEVELIRQL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	bcrypt.h
Biblioteca	Bcrypt.lib
DLL	Bcrypt.dll

Confira também

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer