Função EnumerateSecurityPackagesA (sspi.h)

  • Artigo

A função EnumerateSecurityPackages retorna uma matriz de estruturas SecPkgInfo que fornecem informações sobre os pacotes de segurança disponíveis para o cliente.

Sintaxe

SECURITY_STATUS SEC_ENTRY EnumerateSecurityPackagesA(
  [in] unsigned long *pcPackages,
  [in] PSecPkgInfoA  *ppPackageInfo
);

Parâmetros

[in] pcPackages

Um ponteiro para uma variável ULONG que recebe o número de pacotes disponíveis no sistema. Isso inclui pacotes que já estão carregados e pacotes disponíveis sob demanda.

[in] ppPackageInfo

Um ponteiro para uma variável que recebe um ponteiro para uma matriz de estruturas SecPkgInfo . Cada estrutura contém informações do provedor de suporte de segurança (SSP) que descreve os recursos do pacote de segurança disponível nesse SSP.

Quando terminar de usar a matriz, libere a memória chamando a função FreeContextBuffer .

Retornar valor

Se a função for bem-sucedida, a função retornará SEC_E_OK.

Se a função falhar, ela retornará um código de erro diferente de zero. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor/código retornado Descrição
SEC_E_INSUFFICIENT_MEMORY
0x80090300L
 Não havia memória suficiente para alocar um ou mais buffers.
SEC_E_INVALID_HANDLE
0x80090301L
 Um identificador inválido foi especificado.
SEC_E_SECPKG_NOT_FOUND
0x80090305L
 O pacote especificado não foi encontrado.

Comentários

O chamador pode usar o membro Name de uma estrutura SecPkgInfo para especificar um pacote de segurança em uma chamada para a função AcquireCredentialsHandle (Geral ).

Observação

O cabeçalho sspi.h define EnumerateSecurityPackages como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho sspi.h (inclua Security.h)
Biblioteca Secur32.lib
DLL SspiCli.dll

Confira também

AcquireCredentialsHandle (Geral)

Freecontextbuffer

Funções SSPI

Secpkginfo