Função PsGetSiloContext (ntddk.h)

Artigo
02/07/2025

Essa rotina recupera o contexto do 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 de PsAllocSiloContextSlot.

ReturnedSiloContext

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

Valor de retorno

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 êxito.

Observações

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 ao qual o parâmetro ReturnedSiloContext aponta. O objeto ao qual o parâmetro ReturnedSiloContext deve ser decremente criado 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 status de retorno nesse caso é STATUS_NOT_FOUND.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1607
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
cabeçalho	ntddk.h

Partilhar via