Share via

Função NCryptEnumStorageProviders (ncrypt.h)

  • Artigo

A função NCryptEnumStorageProviders obtém os nomes dos provedores de armazenamento de chaves registrados.

Sintaxe

SECURITY_STATUS NCryptEnumStorageProviders(
  [out] DWORD              *pdwProviderCount,
  [out] NCryptProviderName **ppProviderList,
  [in]  DWORD              dwFlags
);

Parâmetros

[out] pdwProviderCount

O endereço de um DWORD para receber o número de elementos na matriz ppProviderList .

[out] ppProviderList

O endereço de um ponteiro de estrutura NCryptProviderName para receber uma matriz dos nomes de provedor de armazenamento de chaves registrados. A variável apontada pelo parâmetro pdwProviderCount recebe o número de elementos nessa matriz.

Quando essa memória não for mais necessária, libere-a 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.

Valor Significado
NCRYPT_SILENT_FLAG
 Solicita que o KSP (provedor de serviços de chave) não exiba nenhuma interface do usuário. Se o provedor precisar exibir a interface do usuário para operar, a chamada falhará e o KSP deverá definir o código de erro NTE_SILENT_CONTEXT como o último erro.

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
ERROR_SUCCESS
 A função foi bem-sucedida.
NTE_BAD_FLAGS
 O parâmetro dwFlags contém um valor que não é válido.
NTE_INVALID_PARAMETER
 Um ou mais dos parâmetros não são válidos.
NTE_NO_MEMORY
 Ocorreu uma falha de alocação de memória.

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

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

Confira também

NCryptFreeBuffer