Função PsReplaceSiloContext (ntddk.h)

Artigo
02/07/2025

Essa rotina insere um objeto em um Silo .

Sintaxe

NTSTATUS PsReplaceSiloContext(
  [in]       PESILO Silo,
  [in]       ULONG  ContextSlot,
  [in]       PVOID  NewSiloContext,
  [optional] PVOID  *OldSiloContext
);

Parâmetros

[in] Silo

Um ponteiro para um silo. Esse parâmetro é necessário e não pode ser NULL.

[in] ContextSlot

Um slot alocado pela rotina de PsAllocSiloContextSlot.

[in] NewSiloContext

Um ponteiro para o objeto criado pela rotina de PsCreateSiloContext. O objeto deve ser criado usando o mesmo ponteiro de silo que o especificado nessa rotina. Esse parâmetro é necessário e não pode ser NULL.

[optional] OldSiloContext

Um ponteiro para uma variável alocada por chamador que recebe o endereço do objeto existente. Esse parâmetro é opcional e pode ser NULL. O endereço recebido pelo parâmetro 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 é somente leitura e não pode ser modificado. Este é um código de erro.
STATUS_SUCCESS	A operação foi concluída com êxito.

Observações

Uma chamada bem-sucedida para PsReplaceSiloContext incrementa a contagem de referência em NewSiloContext. Se PsReplaceSiloContext falhar, a contagem de referência permanecerá inalterada. Em ambos os casos, o chamador de PsReplaceSiloContext deve chamar PsDereferenceSiloContext para decrementar o objeto PsReplaceSiloContext. Se PsReplaceSiloContext falhar e se o parâmetro OldSiloContext não estiver NULL e não apontar para NULL, NULL será um ponteiro referenciado. Após a conclusão da rotina, o chamador deve chamar PsDereferenceSiloContext para decrementar o objeto ao qual o parâmetro NULL aponta.

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