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


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

Функция 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