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


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

Эта подпрограмма вставляет объект в Silo.

Синтаксис

NTSTATUS PsReplaceSiloContext(
  [in]       PESILO Silo,
  [in]       ULONG  ContextSlot,
  [in]       PVOID  NewSiloContext,
  [optional] PVOID  *OldSiloContext
);

Параметры

[in] Silo

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

[in] ContextSlot

Слот, выделенный подпрограммой PsAllocSiloContextSlot .

[in] NewSiloContext

Указатель на объект, созданный подпрограммой PsCreateSiloContext . Объект должен быть создан с использованием того же указателя силоса, что и указатель, указанный в этой подпрограмме. Этот параметр является обязательным и не может иметь значение NULL.

[optional] OldSiloContext

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

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

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

Код возврата Описание
STATUS_INSUFFICIENT_RESOURCES
В системе нет ресурсов для выполнения вставки. Это код ошибки. 
STATUS_NOT_SUPPORTED
Слот доступен только для чтения и не может быть изменен. Это код ошибки.
STATUS_SUCCESS
Операция выполнена успешно.

Комментарии

Успешный вызов PsReplaceSiloContext увеличивает количество ссылок в NewSiloContext. Если PsReplaceSiloContext завершается сбоем, количество ссылок остается неизменным. В любом случае вызывающий объект PsReplaceSiloContext должен вызвать PsDereferenceSiloContext для уменьшения объекта PsReplaceSiloContext . Если PsReplaceSiloContext завершается ошибкой , а параметр OldSiloContext не имеет значения NULL и не указывает на NULL , то значение NULL является указателем, на который ссылается ссылка. После завершения подпрограммы вызывающий объект должен вызвать PsDereferenceSiloContext для уменьшения объекта, на который указывает параметр NULL .

Требования

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