Função BCryptEnumProviders (bcrypt.h)

Artigo
07/16/2024

A função BCryptEnumProviders obtém todos os provedores de 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. No momento, não há nenhum sinalizador definido, portanto, esse parâmetro deve ser zero.

Valor de retorno

Retorna um código de 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 parâmetros não são válidos.
STATUS_NO_MEMORY	Ocorreu uma falha de alocação de memória.

Observações

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	bcrypt.h
biblioteca	Bcrypt.lib
de DLL	Bcrypt.dll

Consulte também

BCRYPT_PROVIDER_NAME

BCryptFreeBuffer

Compartilhar via