共用方式為

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
目標平臺 窗戶
標頭 ntddk.h