Compartilhar via


Função PsInsertPermanentSiloContext (ntddk.h)

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

[in] SiloContext

O objeto a ser inserido, criado pela rotina PsCreateSiloContext . O objeto deve ser criado usando o mesmo silo especificado no parâmetro Silo . 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_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 sucesso.

Comentários

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