Funzione PsGetSiloContext (ntddk.h)

Articolo
02/07/2025

Questa routine recupera il contesto del 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 del silo. Uno slot allocato dalla routine PsAllocSiloContextSlot.

ReturnedSiloContext

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

Valore restituito

Vengono restituiti i codici di stato NT seguenti.

Codice restituito	Descrizione
STATUS_NOT_FOUND	Codice di stato se il contesto del 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 completata correttamente.

Osservazioni

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 ReturnedSiloContext parametro. L'oggetto a cui punta il parametro ReturnedSiloContext deve essere decrementato chiamando PsDereferenceSiloContext quando non è più necessario. Uno slot di contesto può andare vuoto se il silo viene terminato senza più processi o una chiamata specifica a NtTerminateJobObject. Lo stato restituito in questo caso è STATUS_NOT_FOUND.

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