Función PsGetSiloContext (ntddk.h)

Esta rutina recupera el contexto de silo del silo y la ranura especificados.

Sintaxis

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

Parámetros

[in] Silo

Silo donde va a existir el contexto de silo. Este parámetro es necesario y no puede ser NULL.

[in] ContextSlot

Ranura donde va a existir el contexto de silo. Ranura asignada por la rutina PsAllocSiloContextSlot .

ReturnedSiloContext

Recibe un puntero al que se hace referencia al contexto de silo. En caso de error, el valor recibido será NULL.

Valor devuelto

Se devuelven los siguientes códigos de estado NT.

Código devuelto	Descripción
STATUS_NOT_FOUND	Código de estado si no se encuentra el contexto de silo.
STATUS_INVALID_PARAMETER	Código de estado si se proporcionó un número de ranura no válido como parámetro ContextSlot .
STATUS_SUCCESS	La operación se ha completado correctamente.

Comentarios

La rutina PsGetSiloContext recupera un objeto que se insertó en el silo especificado. Una llamada correcta a esta rutina incrementa el recuento de referencias en el objeto al que apunta el parámetro ReturnedSiloContext . El objeto al que apunta el parámetro ReturnedSiloContext debe disminuir llamando a PsDereferenceSiloContext cuando ya no sea necesario. Una ranura de contexto puede estar vacía si el silo finaliza sin tener más procesos o una llamada específica a NtTerminateJobObject. El estado devuelto en este caso es STATUS_NOT_FOUND.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1607
Servidor mínimo compatible	Windows Server 2016
Plataforma de destino	Windows
Encabezado	ntddk.h