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

2025-02-07

Функция 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	Маркер доступа был успешно открыт.
Другие коды состояния	Произошла ошибка.

Замечания

Процесс, вызывающий fwpsopentoken0, должен иметь привилегию SE_DEBUG_NAME в маркере процесса.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 7.
целевая платформа	Всеобщий
заголовка	fwpsk.h (include Fwpsk.h)
IRQL	<= PASSIVE_LEVEL

См. также

FwpmEngineOpen0