Функция SeCreateClientSecurity (ntifs.h)

Статья
10/04/2023

Подпрограмма SeCreateClientSecurity инициализирует структуру контекста клиента безопасности с информацией, необходимой для вызова SeImpersonateClientEx.

Синтаксис

NTSTATUS SeCreateClientSecurity(
  [in]  PETHREAD                     ClientThread,
  [in]  PSECURITY_QUALITY_OF_SERVICE ClientSecurityQos,
        BOOLEAN                      RemoteSession,
  [out] PSECURITY_CLIENT_CONTEXT     ClientContext
);

Параметры

[in] ClientThread

Указатель на поток клиента для олицетворения.

[in] ClientSecurityQos

Указатель на структуру, выделенную вызывающим объектом SECURITY_QUALITY_OF_SERVICE, указывающую, какая форма олицетворения должна быть выполнена.

RemoteSession

Задайте значение TRUE, если сервер запроса клиента является удаленным.

[out] ClientContext

Указатель на инициализизуемую структуру, выделенную вызывающим объектом SECURITY_CLIENT_CONTEXT.

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

Код возврата	Описание
STATUS_SUCCESS	Контекст клиента безопасности успешно инициализирован.
STATUS_BAD_IMPERSONATION_LEVEL	Клиент, который необходимо олицетворить, в настоящее время олицетворяет своего клиента, и верно одно из следующих значений: (1) Действующий маркер клиента не может быть передан для использования другим сервером, так как его уровень олицетворения — SecurityAnonymous или SecurityIdentification. (2) ServerIsRemote имеет значение TRUE, а поток клиента олицетворяет своего клиента на уровне, отличном от SecurityDelegation .

Код возврата

Описание

STATUS_SUCCESS

Контекст клиента безопасности успешно инициализирован.

STATUS_BAD_IMPERSONATION_LEVEL

Клиент, который необходимо олицетворить, в настоящее время олицетворяет своего клиента, и верно одно из следующих значений: (1) Действующий маркер клиента не может быть передан для использования другим сервером, так как его уровень олицетворения — SecurityAnonymous или SecurityIdentification. (2) ServerIsRemote имеет значение TRUE, а поток клиента олицетворяет своего клиента на уровне, отличном от SecurityDelegation .

Если член ContextTrackingModeclientSecurityQos имеет значение SECURITY_DYNAMIC_TRACKING а serverIsRemote имеет значение FALSE, SeCreateClientSecurity использует ссылку на действующий маркер клиента. В противном случае SeCreateClientSecurity создает копию маркера клиента.

Каждый вызов SeCreateClientSecurity должен быть сопоставлен последующим вызовом SeDeleteClientSecurity.

Дополнительные сведения о безопасности и управлении доступом см. в статье Модель безопасности Windows для разработчиков драйверов и в документации по этим темам в windows SDK.

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

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

SeDeleteClientSecurity

SeImpersonateClientEx

Поделиться через