PsGetSiloContext-Funktion (ntddk.h)

Artikel
02/07/2025

Diese Routine ruft den Silokontext aus dem angegebenen Silo und Steckplatz ab.

Syntax

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

Parameter

[in] Silo

Das Silo, in dem der Silokontext vorhanden ist. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] ContextSlot

Der Platz, an dem der Silokontext vorhanden ist. Ein von der PsAllocSiloContextSlot Routine zugewiesener Slot.

ReturnedSiloContext

Empfängt einen referenzierten Zeiger auf den Silokontext. Bei Einem Fehler wird der empfangene Wert NULL-.

Rückgabewert

Die folgenden NT-Statuscodes werden zurückgegeben.

Rückgabecode	Beschreibung
STATUS_NOT_FOUND	Statuscode, wenn der Silokontext nicht gefunden wird.
STATUS_INVALID_PARAMETER	Statuscode, wenn eine ungültige Slotnummer als ContextSlot Parameter angegeben wurde.
STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.

Bemerkungen

Die PsGetSiloContext Routine ruft ein Objekt ab, das in das angegebene Silo eingefügt wurde. Ein erfolgreicher Aufruf dieser Routine erhöht die Verweisanzahl für das Objekt, auf das der ReturnedSiloContext Parameter verweist. Das Objekt, auf das der ReturnedSiloContext Parameter verweist, muss durch Aufrufen von PsDereferenceSiloContext dekrementiert werden, wenn er nicht mehr benötigt wird. Ein Kontextplatz kann leer gehen, wenn das Silo beendet wird, indem entweder keine prozesse mehr oder ein bestimmter Aufruf von NtTerminateJobObjectbeendet wird. Der Rückgabestatus in diesem Fall ist STATUS_NOT_FOUND.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1607
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Header-	ntddk.h

Freigeben über