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 狀態代碼。
傳回碼 | Description |
---|---|
|
系統中沒有執行插入的資源。 這是錯誤碼。 |
|
此位置是唯讀的,而且無法修改。 這是錯誤碼。 |
|
作業已成功完成。 |
備註
成功呼叫 PsReplaceSiloContext 會遞增 NewSiloContext 上的參考計數。 如果 PsReplaceSiloContext 失敗,則參考計數會保持不變。 不論是哪一種情況, PsReplaceSiloContext 的呼叫端都必須呼叫 PsDereferenceSiloContext 來遞減 PsReplaceSiloContext 物件。 如果 PsReplaceSiloContext 失敗,且 OldSiloContext 參數不是 NULL ,而且不會指向 NULL , 則 NULL 是參考的指標。 例程完成之後,呼叫端必須呼叫 PsDereferenceSiloContext ,以遞減 NULL 參數指向的物件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 10 (版本 1607) |
最低支援的伺服器 | Windows Server 2016 |
目標平台 | Windows |
標頭 | ntddk.h |