PsReplaceSiloContext-Funktion (ntddk.h)

Artikel
02/26/2024

Diese Routine fügt ein Objekt in ein Silo ein.

Syntax

NTSTATUS PsReplaceSiloContext(
  [in]       PESILO Silo,
  [in]       ULONG  ContextSlot,
  [in]       PVOID  NewSiloContext,
  [optional] PVOID  *OldSiloContext
);

Parameter

[in] Silo

Ein Zeiger auf ein Silo. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in] ContextSlot

Ein Von der PsAllocSiloContextSlot-Routine zugeordneter Slot.

[in] NewSiloContext

Ein Zeiger auf das Objekt, das von der PsCreateSiloContext-Routine erstellt wurde. Das Objekt muss mit demselben Silozeiger wie der in dieser Routine angegebene erstellt werden. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[optional] OldSiloContext

Ein Zeiger auf eine vom Aufrufer zugeordnete Variable, die die Adresse des vorhandenen Objekts empfängt. Dieser Parameter ist optional und kann NULL sein. Die Adresse, die der Parameter empfängt, kann 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 schreibgeschützt und kann nicht geändert werden. Dies ist ein Fehlercode.
STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.

Hinweise

Ein erfolgreicher Aufruf von PsReplaceSiloContext erhöht die Verweisanzahl für NewSiloContext. Wenn PsReplaceSiloContext fehlschlägt, bleibt die Verweisanzahl unverändert. In beiden Fällen muss der Aufrufer von PsReplaceSiloContextPsDereferenceSiloContext aufrufen, um das PsReplaceSiloContext-Objekt zu dekrementieren. Wenn PsReplaceSiloContext fehlschlägt und der OldSiloContext-Parameter nicht NULL ist und nicht auf NULL zeigt, ist NULL ein Zeiger, auf den verwiesen wird. Nach Abschluss der Routine muss der Aufrufer PsDereferenceSiloContext aufrufen, um das Objekt zu dekrementieren, auf das der NULL-Parameter zeigt.

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