Функция PsGetSiloContext (ntddk.h)

  • Статья

Эта подпрограмма извлекает контекст хранилища из указанного хранилища и слота.

Синтаксис

NTSTATUS PsGetSiloContext(
  [in] PESILO Silo,
  [in] ULONG  ContextSlot,
       PVOID  *ReturnedSiloContext
);

Параметры

[in] Silo

Хранилище, в котором должен существовать контекст хранилища. Этот параметр является обязательным и не может иметь значение NULL.

[in] ContextSlot

Слот, в котором должен существовать контекст силоса. Слот, выделенный подпрограммой PsAllocSiloContextSlot .

ReturnedSiloContext

Получает указатель, на который ссылается контекст силоса. В случае сбоя полученное значение будет иметь значение NULL.

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

Возвращаются следующие коды состояния NT.

Код возврата Описание
STATUS_NOT_FOUND
 Код состояния, если контекст хранилища не найден.
STATUS_INVALID_PARAMETER
 Код состояния, если в качестве параметра ContextSlot указан недопустимый номер слота.
STATUS_SUCCESS
 Операция выполнена успешно.

Комментарии

Подпрограмма PsGetSiloContext извлекает объект, который был вставлен в указанный хранилище. При успешном вызове этой подпрограммы увеличивается счетчик ссылок на объект, на который указывает параметр ReturnedSiloContext . Объект, на который указывает параметр ReturnedSiloContext , должен быть уменьшен путем вызова PsDereferenceSiloContext , если он больше не нужен. Контекстный слот может быть пустым, если хранилище завершается либо отсутствием процессов, либо конкретным вызовом NtTerminateJobObject. В этом случае возвращается состояние STATUS_NOT_FOUND.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1607
Минимальная версия сервера Windows Server 2016
Целевая платформа Windows
Header ntddk.h