Funzione PsGetSiloContext (ntddk.h)

Articolo
02/26/2024

Questa routine recupera il contesto silo dal silo e dallo slot specificati.

Sintassi

NTSTATUS PsGetSiloContext(
  [in] PESILO Silo,
  [in] ULONG  ContextSlot,
       PVOID  *ReturnedSiloContext
);

Parametri

[in] Silo

Silo in cui deve esistere il contesto del silo. Questo parametro è obbligatorio e non può essere NULL.

[in] ContextSlot

Slot in cui deve esistere il contesto silo. Slot allocato dalla routine PsAllocSiloContextSlot .

ReturnedSiloContext

Riceve un puntatore a cui si fa riferimento al contesto silo. In caso di errore, il valore ricevuto sarà NULL.

Valore restituito

Vengono restituiti i codici di stato NT seguenti.

Codice restituito	Descrizione
STATUS_NOT_FOUND	Codice di stato se il contesto silo non viene trovato.
STATUS_INVALID_PARAMETER	Codice di stato se è stato specificato un numero di slot non valido come parametro ContextSlot .
STATUS_SUCCESS	Operazione riuscita.

Commenti

La routine PsGetSiloContext recupera un oggetto inserito nel silo specificato. Una chiamata riuscita a questa routine incrementa il conteggio dei riferimenti sull'oggetto a cui punta il parametro ReturnedSiloContext . L'oggetto a cui punta il parametro ReturnedSiloContext deve essere decrementato chiamando PsDereferenceSiloContext quando non è più necessario. Uno slot di contesto può essere vuoto se il silo viene terminato senza più processi o una chiamata specifica a NtTerminateJobObject. Lo stato restituito in questo caso è STATUS_NOT_FOUND.

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