PsGetSiloContext 函数 (ntddk.h)
此例程从指定的 silo 和槽中检索 silo 上下文。
语法
NTSTATUS PsGetSiloContext(
[in] PESILO Silo,
[in] ULONG ContextSlot,
PVOID *ReturnedSiloContext
);
参数
[in] Silo
silo 上下文所在的 silo。 此参数是必需的,不能为 NULL。
[in] ContextSlot
silo 上下文所在的槽。 由 PsAllocSiloContextSlot 例程分配的槽。
ReturnedSiloContext
接收指向 silo 上下文的引用指针。 失败时,收到的值为 NULL。
返回值
返回以下 NT 状态代码。
返回代码 | 说明 |
---|---|
|
如果未找到 silo 上下文,则为状态代码。 |
|
如果作为 ContextSlot 参数提供了无效的槽号,则为状态代码。 |
|
操作已成功完成。 |
注解
PsGetSiloContext 例程检索插入到指定 silo 中的对象。 成功调用此例程会递增 ReturnedSiloContext 参数指向的对象上的引用计数。 ReturnedSiloContext 参数指向的对象必须在不再需要时通过调用 PsDereferenceSiloContext 来递减。 如果接收器因没有更多进程或对 NtTerminateJobObject 的特定调用而终止,则上下文槽可能为空。 在这种情况下,返回状态 为STATUS_NOT_FOUND。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 版本 1607 |
最低受支持的服务器 | Windows Server 2016 |
目标平台 | Windows |
标头 | ntddk.h |