Функция PsReferencePrimaryToken (ntifs.h)
Подпрограмма PsReferencePrimaryToken увеличивает количество ссылок основного маркера для указанного процесса.
Синтаксис
PACCESS_TOKEN PsReferencePrimaryToken(
[in, out] PEPROCESS Process
);
Параметры
[in, out] Process
Указатель на процесс, для которого необходимо увеличить число ссылок основного маркера.
Возвращаемое значение
PsReferencePrimaryToken возвращает указатель на основной токен для данного процесса.
Комментарии
PsReferencePrimaryToken увеличивает число ссылок возвращенного первичного маркера. Таким образом, для каждого успешного вызова PsReferencePrimaryToken количество ссылок основного маркера должно уменьшаться путем вызова одной из следующих функций:
- ObDereferenceObject для Windows 2000
- PsDereferencePrimaryToken для Microsoft Windows XP и более поздних версий
Дополнительные сведения о безопасности и управлении доступом см. в статье Модель безопасности Windows для разработчиков драйверов и в документации по этим темам в windows SDK.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 |
| Целевая платформа | Универсальное |
| Верхняя часть | ntifs.h (включая FltKernel.h, Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Правила соответствия DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |