PsGetSiloContext function (ntddk.h)

This routine retrieves the silo context from the specified silo and slot.

Syntax

NTSTATUS PsGetSiloContext(
  [in] PESILO Silo,
  [in] ULONG  ContextSlot,
       PVOID  *ReturnedSiloContext
);

Parameters

[in] Silo

The silo where the silo context is to exist. This parameter is required and it cannot be NULL.

[in] ContextSlot

The slot where the silo context is to exist. A slot allocated by the PsAllocSiloContextSlot routine.

ReturnedSiloContext

Receives a referenced pointer to the silo context. On failure, the value received will be NULL.

Return value

The following NT status codes are returned.

Return code Description
STATUS_NOT_FOUND
Status code if the silo context is not found.
STATUS_INVALID_PARAMETER
Status code if an invalid slot number was supplied as the ContextSlot parameter.
STATUS_SUCCESS
The operation completed successfully.

Remarks

The PsGetSiloContext routine retrieves an object that was inserted in the specified silo. A successful call to this routine increments the reference count on the object that the ReturnedSiloContext parameter points to. The object that the ReturnedSiloContext parameter points to, must be decremented by calling PsDereferenceSiloContext when it is no longer needed. A context slot may go empty if the silo is being terminated by either having no more processes or a specific call to NtTerminateJobObject. The return status in this case is STATUS_NOT_FOUND.

Requirements

   
Minimum supported client Windows 10, version 1607
Minimum supported server Windows Server 2016
Target Platform Windows
Header ntddk.h