Compartilhar via

Função LsaLookupAuthenticationPackage (ntsecapi.h)

  • Artigo

A função LsaLookupAuthenticationPackage obtém o identificador exclusivo de um pacote de autenticação.

Sintaxe

NTSTATUS LsaLookupAuthenticationPackage(
  [in]  HANDLE      LsaHandle,
  [in]  PLSA_STRING PackageName,
  [out] PULONG      AuthenticationPackage
);

Parâmetros

[in] LsaHandle

Identificador obtido de uma chamada anterior para LsaRegisterLogonProcess ou LsaConnectUntrusted.

[in] PackageName

Ponteiro para uma estrutura LSA_STRING que especifica o nome do pacote de autenticação. O nome do pacote não deve exceder 127 bytes de comprimento. A tabela a seguir lista os nomes dos pacotes de autenticação fornecidos pela Microsoft.

Valor Significado
MSV1_0_PACKAGE_NAME
 Versão ANSI do MSV1_0 nome do pacote de autenticação.
MICROSOFT_KERBEROS_NAME_A
 Versão ANSI do nome do pacote de autenticação Kerberos.
NEGOSSP_NAME_A
 Versão ANSI do nome do pacote de autenticação Negotiate.

[out] AuthenticationPackage

Ponteiro para um ULONG que recebe o identificador do pacote de autenticação.

Retornar valor

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um código NTSTATUS. Veja a seguir possíveis códigos de erro.

Código de retorno Descrição
STATUS_NO_SUCH_PACKAGE
 O pacote de autenticação especificado é desconhecido para a LSA.
STATUS_NAME_TOO_LONG
 O nome do pacote de autenticação excede 127 bytes.
 

Para obter mais informações, consulte Valores retornados da função de política LSA.

A função LsaNtStatusToWinError converte um código NTSTATUS em um código de erro do Windows.

Comentários

O identificador do pacote de autenticação é usado em chamadas para funções de autenticação, como LsaLogonUser e LsaCallAuthenticationPackage.

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 ntsecapi.h
Biblioteca Secur32.lib
DLL Secur32.dll

Confira também

LsaCallAuthenticationPackage

Lsalogonuser