PsGetSiloContext-Funktion (ntddk.h)

  • Artikel

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

Syntax

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

Parameter

[in] Silo

Der Silo, in dem der Silokontext vorhanden sein soll. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in] ContextSlot

Der Slot, in dem der Silokontext vorhanden sein soll. Ein Von der PsAllocSiloContextSlot-Routine zugeordneter Slot.

ReturnedSiloContext

Empfängt einen Zeiger, auf den verwiesen wird, auf den Silokontext. Bei einem Fehler ist der empfangene Wert NULL.

Rückgabewert

Die folgenden NT-status-Codes 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.

Hinweise

Die PsGetSiloContext-Routine ruft ein Objekt ab, das in das angegebene Silo eingefügt wurde. Bei einem erfolgreichen Aufruf dieser Routine wird die Verweisanzahl für das Objekt erhöht, auf das der ReturnedSiloContext-Parameter verweist. Das Objekt, auf das der ReturnedSiloContext-Parameter zeigt, muss durch Aufrufen von PsDereferenceSiloContext dekrementiert werden, wenn es nicht mehr benötigt wird. Ein Kontextslot kann leer werden, wenn der Silo entweder durch keine weiteren Prozesse oder einen bestimmten Aufruf von NtTerminateJobObject beendet wird. Die rückgabe status ist in diesem Fall STATUS_NOT_FOUND.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1607
Unterstützte Mindestversion (Server) Windows Server 2016
Zielplattform Windows
Kopfzeile ntddk.h