PsInsertPermanentSiloContext-Funktion (ntddk.h)

Artikel
02/29/2024

Diese Routine fügt ein Objekt in einen leeren Slot 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 darf nicht NULL sein.

[in] ContextSlot

Der Slot, 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 demselben Silo wie im Silo-Parameter angegeben erstellt werden. Dieser Parameter ist erforderlich und darf nicht NULL sein.

Rückgabewert

Die folgenden NT-status-Codes 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 Slot ist nicht leer. Dies ist ein Fehlercode.
STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.

Hinweise

Ein erfolgreicher Aufruf von PsInsertPermanentSiloContext erhöht die Verweisanzahl für 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 dekrementieren.

Anforderungen

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

Freigeben über