Função PsReplaceSiloContext (ntddk.h)

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

[in] NewSiloContext

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

Comentários

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 for 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 para o qual o parâmetro NULL aponta.

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