Função EnumerateSecurityPackagesA (sspi.h)
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 |
---|---|
|
Não havia memória suficiente para alocar um ou mais buffers. |
|
Um identificador inválido foi especificado. |
|
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 |