Funzione PsReplaceSiloContext (ntddk.h)

Articolo
02/26/2024

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

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

Commenti

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 .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1607
Server minimo supportato	Windows Server 2016
Piattaforma di destinazione	Windows
Intestazione	ntddk.h

Condividi tramite