Função EnumerateSecurityPackagesA (sspi.h)

Artigo
11/20/2024

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 já 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.

Valor de retorno

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 valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

Código/valor de retorno	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.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

AcquireCredentialsHandle (Geral)

FreeContextBuffer

Funções SSPI

SecPkgInfo

Compartilhar via