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 状态代码。

返回代码 说明
STATUS_NOT_FOUND
 如果未找到 silo 上下文，则为状态代码。
STATUS_INVALID_PARAMETER
 如果作为 ContextSlot 参数提供了无效的槽号，则为状态代码。
STATUS_SUCCESS
 操作已成功完成。

注解

PsGetSiloContext 例程检索插入到指定 silo 中的对象。 成功调用此例程会递增 ReturnedSiloContext 参数指向的对象上的引用计数。 ReturnedSiloContext 参数指向的对象必须在不再需要时通过调用 PsDereferenceSiloContext 来递减。 如果接收器因没有更多进程或对 NtTerminateJobObject 的特定调用而终止，则上下文槽可能为空。 在这种情况下，返回状态 为STATUS_NOT_FOUND。

要求

要求 值
最低受支持的客户端 Windows 10 版本 1607
最低受支持的服务器 Windows Server 2016
目标平台 Windows
标头 ntddk.h