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

Статья
02/07/2025

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

Синтаксис

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

Параметры

[in] Silo

Указатель на сило. Этот параметр является обязательным, и он не может быть null.

[in] ContextSlot

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

[in] NewSiloContext

Указатель на объект, созданный подпрограммой PsCreateSiloCon text. Объект должен быть создан с помощью того же указателя СИЛО, что и в этой подпрограмме. Этот параметр является обязательным, и он не может быть null.

[optional] OldSiloContext

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

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

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

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

Замечания

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1607
минимальный поддерживаемый сервер	Windows Server 2016
целевая платформа	Виндоус
заголовка	ntddk.h

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