PsInsertPermanentSiloContext-Funktion (ntddk.h)

Artikel
02/07/2025

Diese Routine fügt ein Objekt in einen leeren Steckplatz in einem Silo-ein.

Syntax

NTSTATUS PsInsertPermanentSiloContext(
  [in] PESILO Silo,
  [in] ULONG  ContextSlot,
  [in] PVOID  SiloContext
);

Parameter

[in] Silo

Das Silo, in das das Objekt eingefügt werden soll. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

[in] ContextSlot

Der Steckplatz, in den das Objekt eingefügt werden soll. Ein von der PsAllocSiloContextSlot Routine zugewiesener Slot.

[in] SiloContext

Das einzufügende Objekt, das von der PsCreateSiloContext Routine erstellt wird. Das Objekt muss mit dem gleichen Silo erstellt werden, wie im parameter Silo angegeben. Dieser Parameter ist erforderlich und kann nicht NULL-werden.

Rückgabewert

Die folgenden NT-Statuscodes werden zurückgegeben.

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Es gibt keine Ressourcen im System, um den Einfügevorgang auszuführen. Dies ist ein Fehlercode.
STATUS_NOT_SUPPORTED	Der Steckplatz ist nicht leer. Dies ist ein Fehlercode.
STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.

Bemerkungen

Ein erfolgreicher Aufruf von PsInsertPermanentSiloContext erhöht die Verweisanzahl auf SiloContext-. Wenn PsInsertPermanentSiloContext fehlschlägt, bleibt die Verweisanzahl unverändert. In beiden Fällen muss der Aufrufer nach Abschluss der Routine PsDereferenceSiloContext- aufrufen, um das SiloContext--Objekt zu verringern.

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