PsInsertPermanentSiloContext 函式 (ntddk.h)

  • 發行項

這個例程會將物件插入 到接收器中的空白位置。

語法

NTSTATUS PsInsertPermanentSiloContext(
  [in] PESILO Silo,
  [in] ULONG  ContextSlot,
  [in] PVOID  SiloContext
);

參數

[in] Silo

要插入物件的尋址接收器。 這個參數是必要的，而且不能是 NULL。

[in] ContextSlot

要插入物件的位置。 PsAllocSiloContextSlot 例程所配置的插槽。

[in] SiloContext

要插入的物件，由 PsCreateSiloContext 例程所建立。 必須使用與 Silo 參數中指定的相同 尋址接收器 來建立物件。 這個參數是必要的，而且不能是 NULL。

傳回值

會傳回下列 NT 狀態代碼。

傳回碼 Description
STATUS_INSUFFICIENT_RESOURCES
 系統中沒有執行插入的資源。 這是錯誤碼。 
STATUS_NOT_SUPPORTED
 此位置不是空的。 這是錯誤碼。
STATUS_SUCCESS
 作業已成功完成。

備註

成功呼叫 PsInsertPermanentSiloContext 會遞增 SiloContext 上的參考計數。 如果 PsInsertPermanentSiloContext 失敗，則參考計數會保持不變。 在任一情況下，在例程完成之後，呼叫端必須呼叫 PsDereferenceSiloContext 來遞減 SiloContext 物件。

規格需求

需求 值
最低支援的用戶端 Windows 10 (版本 1607)
最低支援的伺服器 Windows Server 2016
目標平台 Windows
標頭 ntddk.h