Função PsGetSiloContext (ntddk.h)

Essa rotina recupera o contexto de silo do silo e do slot especificados.

Sintaxe

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

Parâmetros

[in] Silo

O silo em que o contexto do silo deve existir. Esse parâmetro é necessário e não pode ser NULL.

[in] ContextSlot

O slot em que o contexto do silo deve existir. Um slot alocado pela rotina PsAllocSiloContextSlot .

ReturnedSiloContext

Recebe um ponteiro referenciado para o contexto do silo. Em caso de falha, o valor recebido será NULL.

Retornar valor

Os seguintes códigos de status NT são retornados.

Comentários

A rotina PsGetSiloContext recupera um objeto que foi inserido no silo especificado. Uma chamada bem-sucedida para essa rotina incrementa a contagem de referência no objeto para o qual o parâmetro ReturnedSiloContext aponta. O objeto para o qual o parâmetro ReturnedSiloContext aponta deve ser decrementado chamando PsDereferenceSiloContext quando ele não for mais necessário. Um slot de contexto poderá ficar vazio se o silo estiver sendo encerrado por não ter mais processos ou uma chamada específica para NtTerminateJobObject. O retorno status nesse caso é STATUS_NOT_FOUND.

Requisitos