Função PsInsertPermanentSiloContext (ntddk.h)

Artigo
02/07/2025

Essa rotina insere um objeto em um slot vazio em um Silo .

Sintaxe

NTSTATUS PsInsertPermanentSiloContext(
  [in] PESILO Silo,
  [in] ULONG  ContextSlot,
  [in] PVOID  SiloContext
);

Parâmetros

[in] Silo

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

[in] ContextSlot

O slot no qual o objeto deve ser inserido. Um slot alocado pela rotina de PsAllocSiloContextSlot.

[in] SiloContext

O objeto a ser inserido, criado pela rotina de PsCreateSiloContext. O objeto deve ser criado usando o mesmo silo especificado no parâmetro do Silo. 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_INSUFFICIENT_RESOURCES	Não há recursos no sistema para executar a inserção. Este é um código de erro.
STATUS_NOT_SUPPORTED	O slot não está vazio. Este é um código de erro.
STATUS_SUCCESS	A operação foi concluída com êxito.

Observações

Uma chamada bem-sucedida para PsInsertPermanentSiloContext incrementa a contagem de referência em SiloContext. Se PsInsertPermanentSiloContext falhar, a contagem de referência permanecerá inalterada. Em ambos os casos, após a conclusão da rotina, o chamador deve chamar PsDereferenceSiloContext para decrementar o objeto SiloContext.

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