Função NCryptEnumAlgorithms (ncrypt.h)

A função NCryptEnumAlgorithms obtém os nomes dos algoritmos compatíveis com o provedor de armazenamento de chaves especificado.

Sintaxe

SECURITY_STATUS NCryptEnumAlgorithms(
  [in]  NCRYPT_PROV_HANDLE  hProvider,
  [in]  DWORD               dwAlgOperations,
  [out] DWORD               *pdwAlgCount,
  [out] NCryptAlgorithmName **ppAlgList,
  [in]  DWORD               dwFlags
);

Parâmetros

[in] hProvider

O identificador do provedor de armazenamento de chaves para o qual enumerar os algoritmos. Esse identificador é obtido com a função NCryptOpenStorageProvider .

[in] dwAlgOperations

Um conjunto de valores que determinam quais classes de algoritmo devem ser enumeradas. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir. Se dwAlgOperations for zero, todos os algoritmos serão enumerados.

[out] pdwAlgCount

O endereço de um DWORD que recebe o número de elementos na matriz ppAlgList .

[out] ppAlgList

O endereço de um ponteiro de estrutura NCryptAlgorithmName que recebe uma matriz dos nomes de algoritmo registrados. A variável apontada pelo parâmetro pdwAlgCount recebe o número de elementos nessa matriz.

Quando essa memória não for mais necessária, ela deverá ser liberada passando esse ponteiro para a função NCryptFreeBuffer .

[in] dwFlags

Sinalizadores que modificam o comportamento da função. Isso pode ser zero (0) ou o valor a seguir.

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.

Comentários

Um serviço não deve chamar essa função de sua Função StartService. Se um serviço chamar essa função de sua função StartService, um deadlock poderá ocorrer e o serviço poderá parar de responder.

Requisitos