Функция LsaConnectUntrusted (ntsecapi.h)

  • Статья

Функция LsaConnectUntrusted устанавливает ненадежное подключение к серверу LSA.

Синтаксис

NTSTATUS LsaConnectUntrusted(
  [out] PHANDLE LsaHandle
);

Параметры

[out] LsaHandle

Указатель на дескриптор, который получает дескриптор подключения, который должен быть предоставлен в будущих службах проверки подлинности.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет STATUS_SUCCESS.

Если функция завершается сбоем, возвращаемым значением будет код NTSTATUS. Дополнительные сведения см. в разделе Возвращаемые значения функции политики LSA.

Функция LsaNtStatusToWinError преобразует код NTSTATUS в код ошибки Windows.

Комментарии

LsaConnectUntrusted возвращает дескриптор для ненадежного подключения; он не проверяет какие-либо сведения о вызывающем объекте. Дескриптор должен быть закрыт с помощью функции LsaDeregisterLogonProcess .

Если приложению просто требуется запрашивать сведения из пакетов проверки подлинности, можно использовать дескриптор, возвращенный этой функцией, в вызовах LsaCallAuthenticationPackage и LsaLookupAuthenticationPackage.

Приложения с привилегией SeTcbPrivilege могут создать доверенное подключение, вызвав LsaRegisterLogonProcess.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header ntsecapi.h
Библиотека Secur32.lib
DLL Secur32.dll

См. также раздел

LsaCallAuthenticationPackage

LsaDeregisterLogonProcess

LsaLookupAuthenticationPackage

LsaRegisterLogonProcess