PsGetSiloContext-Funktion (ntddk.h)
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 |
---|---|
|
Statuscode, wenn der Silokontext nicht gefunden wird. |
|
Statuscode, wenn eine ungültige Slotnummer als ContextSlot Parameter angegeben wurde. |
|
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 |