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 se va a existir el contexto de silo. Este parámetro es necesario y no se puede null.

[in] ContextSlot

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

ReturnedSiloContext

Recibe un puntero al que se hace referencia al contexto de silo. Si se produce un error, el valor recibido se 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 completó correctamente.

Observaciones

La rutina PsGetSiloContext recupera un objeto insertado 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 decrementarse llamando a PsDereferenceSiloContext cuando ya no sea necesario. Una ranura de contexto puede estar vacía si el silo finaliza sin más procesos o una llamada específica a NtTerminateJobObject. El estado de devolución en este caso es STATUS_NOT_FOUND.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 10, versión 1607
servidor mínimo admitido	Windows Server 2016
de la plataforma de destino de	Windows
encabezado de	ntddk.h