PsInsertPermanentSiloContext-Funktion (ntddk.h)

  • Artikel

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