Função PsGetSiloContext (ntddk.h)

  • Artigo

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.

Código de retorno Descrição
STATUS_NOT_FOUND
 Código de status se o contexto do silo não for encontrado.
STATUS_INVALID_PARAMETER
 Código de status se um número de slot inválido foi fornecido como o parâmetro ContextSlot .
STATUS_SUCCESS
 A operação foi concluída com sucesso.

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

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1607
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Cabeçalho ntddk.h