Fonction PsGetSiloContext (ntddk.h)

Article
02/26/2024

Cette routine récupère le contexte de silo à partir du silo et de l’emplacement spécifiés.

Syntaxe

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

Paramètres

[in] Silo

Silo dans lequel le contexte du silo doit exister. Ce paramètre est obligatoire et ne peut pas être NULL.

[in] ContextSlot

Emplacement dans lequel le contexte de silo doit exister. Emplacement alloué par la routine PsAllocSiloContextSlot .

ReturnedSiloContext

Reçoit un pointeur référencé vers le contexte de silo. En cas d’échec, la valeur reçue est NULL.

Valeur retournée

Les codes de status NT suivants sont retournés.

Code de retour	Description
STATUS_NOT_FOUND	Code d’état si le contexte de silo est introuvable.
STATUS_INVALID_PARAMETER	Code d’état si un numéro d’emplacement non valide a été fourni en tant que paramètre ContextSlot .
STATUS_SUCCESS	L’opération s’est terminée avec succès.

Remarques

La routine PsGetSiloContext récupère un objet qui a été inséré dans le silo spécifié. Un appel réussi à cette routine incrémente le nombre de références sur l’objet vers lequel pointe le paramètre ReturnedSiloContext . L’objet vers lequel pointe le paramètre ReturnedSiloContext doit être décrémenté en appelant PsDereferenceSiloContext lorsqu’il n’est plus nécessaire. Un emplacement de contexte peut devenir vide si le silo se termine par l’absence de processus supplémentaires ou par un appel spécifique à NtTerminateJobObject. Dans ce cas, la status de retour est STATUS_NOT_FOUND.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1607
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
En-tête	ntddk.h

Partager via