Função PsGetPermanentSiloContext (ntddk.h)

Artigo
02/07/2025

Essa rotina recupera um objeto que foi inserido no Silo sem incrementar a contagem de referência.

Sintaxe

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

Parâmetros

[in] Silo

O silo no qual o objeto foi inserido. Esse parâmetro é necessário e não pode ser NULL.

[in] ContextSlot

O slot somente leitura que foi alocado anteriormente por PsAllocSiloContextSlot e feito somente leitura por PsMakeSiloContextPermanent.

ReturnedSiloContext

Um ponteiro para uma variável alocada por chamador que recebe o endereço do objeto existente. Esse parâmetro é necessário e não pode ser NULL.

Valor de retorno

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

Código de retorno	Descrição
STATUS_NOT_FOUND	O slot está vazio. Este é um código de erro.
STATUS_NOT_SUPPORTED	O slot não é somente leitura e não pode recuperar o objeto com segurança. Este é um código de erro.
STATUS_SUCCESS	A operação foi concluída com êxito.

Observações

Uma chamada bem-sucedida para PsGetPermanentSiloContext não incrementa a contagem de referência no objeto ao qual o parâmetro ReturnedSiloContext aponta. O ponteiro de objeto retornado é válido desde que haja uma referência válida no objeto silo.

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

Compartilhar via