Функция FwpsOpenToken0 (fwpsk.h)

Статья
08/07/2023

Функция FwpsOpenToken0 открывает маркер доступа.

ПримечаниеFwpsOpenToken0 — это определенная версия FwpsOpenToken. Дополнительные сведения см. в разделах Имена Version-Independent и Выбор конкретных версий Windows .

Синтаксис

NTSTATUS FwpsOpenToken0(
  [in]  IN HANDLE  engineHandle,
  [in]  IN LUID    modifiedId,
  [in]  IN DWORD   desiredAccess,
  [out] OUT HANDLE *accessToken
);

Параметры

[in] engineHandle

Дескриптор открытого сеанса для подсистемы фильтрации. Драйвер выноски вызывает функцию FwpmEngineOpen0 , чтобы открыть сеанс для подсистемы фильтрации.

[in] modifiedId

Указывает LUID , который изменяется при каждом изменении маркера. Приложение может использовать это значение в качестве проверки того, изменился ли контекст безопасности с момента последнего использования.

[in] desiredAccess

ACCESS_MASK структуры, указывающей запрошенные типы доступа к маркеру доступа. Эти запрошенные типы доступа сравниваются со списком управления доступом (DACL) маркера, чтобы определить, какой доступ предоставляется или запрещается.

[out] accessToken

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

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

Функция FwpsOpenToken0 возвращает один из следующих кодов NTSTATUS.

Код возврата	Описание
STATUS_SUCCESS	Маркер доступа был успешно открыт.
Другие коды состояния	Произошла ошибка.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 7.
Целевая платформа	Универсальное
Верхняя часть	fwpsk.h (включая Fwpsk.h)
IRQL	<= PASSIVE_LEVEL

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

FwpmEngineOpen0