Compartilhar via


Função LsaConnectUntrusted (ntsecapi.h)

A função LsaConnectUntrusted estabelece uma conexão não confiável com o servidor LSA.

Sintaxe

NTSTATUS LsaConnectUntrusted(
  [out] PHANDLE LsaHandle
);

Parâmetros

[out] LsaHandle

Ponteiro para um identificador que recebe o identificador de conexão, que deve ser fornecido em serviços de autenticação futuros.

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

LsaConnectUntrusted retorna um identificador para uma conexão não confiável; ele não verifica nenhuma informação sobre o chamador. O identificador deve ser fechado usando a função LsaDeregisterLogonProcess .

Se o aplicativo precisar simplesmente consultar informações de pacotes de autenticação, você poderá usar o identificador retornado por essa função em chamadas para LsaCallAuthenticationPackage e LsaLookupAuthenticationPackage.

Aplicativos com o privilégio SeTcbPrivilege podem criar uma conexão confiável chamando LsaRegisterLogonProcess.

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

LsaDeregisterLogonProcess

LsaLookupAuthenticationPackage

LsaRegisterLogonProcess