функция обратного вызова LSA_AP_CALL_PACKAGE_PASSTHROUGH (ntsecpkg.h)

Статья
08/25/2023

Функция диспетчеризации для запросов сквозного входа, отправляемых в функцию LsaCallAuthenticationPackage .

Синтаксис

LSA_AP_CALL_PACKAGE_PASSTHROUGH LsaApCallPackagePassthrough;

NTSTATUS LsaApCallPackagePassthrough(
  [in]  PLSA_CLIENT_REQUEST ClientRequest,
  [in]  PVOID ProtocolSubmitBuffer,
  [in]  PVOID ClientBufferBase,
  [in]  ULONG SubmitBufferLength,
  [out] PVOID *ProtocolReturnBuffer,
  [out] PULONG ReturnBufferLength,
  [out] PNTSTATUS ProtocolStatus
)
{...}

Параметры

[in] ClientRequest

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

[in] ProtocolSubmitBuffer

Предоставляет в пакет проверки подлинности сообщение, зависят от протокола.

[in] ClientBufferBase

Предоставляет адрес в клиентском процессе сообщения протокола. Это может потребоваться для повторного сопоставления указателей в ProtocolSubmitBuffer.

[in] SubmitBufferLength

Указывает длину буфера ProtocolSubmitBuffer в байтах.

[out] ProtocolReturnBuffer

Возвращает адрес выходного буфера в клиентском процессе. Пакет проверки подлинности отвечает за вызов функции AllocateClientBuffer для выделения буфера в клиентском процессе. Содержимое этого буфера зависит от пакета проверки подлинности.

[out] ReturnBufferLength

Указатель на ULONG , возвращающий длину буфера ProtocolReturnBuffer в байтах.

[out] ProtocolStatus

Указатель на значение NTSTATUS. Если функция возвращает STATUS_SUCCESS, ProtocolStatus возвращает состояние завершения, заданное пакетом проверки подлинности. Значения ProtocolStatus относятся к пакету проверки подлинности.

Дополнительные сведения о кодах NTSTATUS можно найти в файле Subauth.h, поставляемом вместе с пакетом SDK для платформы.

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

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

Если пакет проверки подлинности не смог обработать запрос и, следовательно, не пытался предоставить запрошенную службу, верните код NTSTATUS, указывающий на проблему. Этот код может быть следующим значением или одним из возвращаемых значений функции политики LSA.

Код возврата	Описание
STATUS_NO_MEMORY	Квота памяти клиента недостаточна для выделения выходного буфера.

Требования

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

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

AllocateClientBuffer

LsaCallAuthenticationPackage