Compartilhar via


Função PsGetPermanentSiloContext (ntddk.h)

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 porPsAllocSiloContextSlot e feito somente leitura por PsMakeSiloContextPermanent.

ReturnedSiloContext

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

Retornar valor

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 sucesso.

Comentários

Uma chamada bem-sucedida para PsGetPermanentSiloContext não incrementa a contagem de referência no objeto para o 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
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