Funzione PsReplaceSiloContext (ntddk.h)

Articolo
02/07/2025

Questa routine inserisce un oggetto in un Silo.

Sintassi

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

Parametri

[in] Silo

Puntatore a un silo. Questo parametro è obbligatorio e non può essere NULL.

[in] ContextSlot

Uno slot allocato dalla routine PsAllocSiloContextSlot.

[in] NewSiloContext

Puntatore all'oggetto creato dalla routine PsCreateSiloContext. L'oggetto deve essere creato utilizzando lo stesso puntatore silo di quello specificato in questa routine. Questo parametro è obbligatorio e non può essere NULL.

[optional] OldSiloContext

Puntatore a una variabile allocata dal chiamante che riceve l'indirizzo dell'oggetto esistente. Questo parametro è facoltativo e può essere NULL. L'indirizzo ricevuto dal parametro può essere NULL.

Valore restituito

Vengono restituiti i codici di stato NT seguenti.

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	Non sono presenti risorse nel sistema per eseguire l'inserimento. Si tratta di un codice di errore.
STATUS_NOT_SUPPORTED	Lo slot è di sola lettura e non può essere modificato. Si tratta di un codice di errore.
STATUS_SUCCESS	Operazione completata correttamente.

Osservazioni

Una chiamata riuscita a PsReplaceSiloContext incrementa il conteggio dei riferimenti in NewSiloContext. Se PsReplaceSiloContext ha esito negativo, il conteggio dei riferimenti rimane invariato. In entrambi i casi, il chiamante di PsReplaceSiloContext deve chiamare PsDereferenceSiloContext per decrementare l'oggetto PsReplaceSiloContext. Se PsReplaceSiloContext ha esito negativo e se il parametro OldSiloContext non è NULL e non punta a NULL, NULL è un puntatore a cui si fa riferimento. Al termine della routine, il chiamante deve chiamare PsDereferenceSiloContext per decrementare l'oggetto a cui punta il parametro NULL.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1607
server minimo supportato	Windows Server 2016
piattaforma di destinazione	Finestre
intestazione	ntddk.h

Condividi tramite