PsReplaceSiloContext-Funktion (ntddk.h)

Diese Routine fügt ein Objekt in eine 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 kann nicht NULL-werden.

[in] ContextSlot

Ein von der PsAllocSiloContextSlot Routine zugewiesener 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 kann nicht NULL-werden.

[optional] OldSiloContext

Ein Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Adresse des vorhandenen Objekts empfängt. Dieser Parameter ist optional und kann NULL-werden. Die Adresse, die der Parameter empfängt, kann NULL-sein.

Rückgabewert

Die folgenden NT-Statuscodes werden zurückgegeben.

Bemerkungen

Ein erfolgreicher Aufruf von PsReplaceSiloContext erhöht die Verweisanzahl auf 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 verringern. Wenn PsReplaceSiloContext fehlschlägt und der OldSiloContext-Parameter nicht NULL- ist und nicht auf NULL- zeigt, ist NULL- ein Referenzzeiger. Nach Abschluss der Routine muss der Aufrufer PsDereferenceSiloContext- aufrufen, um das Objekt zu verringern, auf das der NULL--Parameter verweist.

Anforderungen