RtlRealSuccessor-Funktion (ntddk.h)

Die RtlRealSuccessor Routine gibt einen Zeiger auf den Nachfolger des angegebenen Knotens in der Wiedergabelinkstruktur zurück.

Syntax

NTSYSAPI PRTL_SPLAY_LINKS RtlRealSuccessor(
  [in] PRTL_SPLAY_LINKS Links
);

Parameter

[in] Links

Zeigen Sie auf den Knoten. Der Knoten muss durch Aufrufen von RtlInitializeSplayLinksinitialisiert worden sein.

Rückgabewert

RtlRealSuccessor gibt einen Zeiger auf den Nachfolger des Knotens bei Linkszurück oder NULL-, wenn der Knoten keinen Nachfolger hat.

Bemerkungen

Der tatsächliche Nachfolger eines bestimmten Knotens wird wie folgt bestimmt:

• Wenn der angegebene Knoten über eine rechte Unterstruktur verfügt, ist der äußerst linke Knoten in der rechten Unterstruktur des Knotens bei Verknüpfungen der Nachfolger. Beachten Sie, dass RtlSubtreeSuccessor dasselbe Ergebnis für diesen Fall zurückgibt.
• Andernfalls ist der nächste Vorgängerknoten, von dem der angegebene Knoten ein untergeordneter Untergeordneter Knoten ist, der Nachfolger.

Anrufer der Rtl- Wiedergabelinkroutinen sind für die Synchronisierung des Zugriffs auf die Wiedergabelinkstruktur verantwortlich. Ein schneller Mutex ist der effizienteste Synchronisierungsmechanismus, der für diesen Zweck verwendet werden kann.

Anrufer von RtlRealSuccessor- müssen bei IRQL-<= DISPATCH_LEVEL ausgeführt werden, wenn die Struktur nichtpaged ist. In der Regel werden Aufrufer bei IRQL-PASSIVE_LEVEL ausgeführt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Diese Routine ist unter Microsoft Windows 2000 und höher verfügbar.
Zielplattform-	Universal
Header-	ntddk.h (enthalten Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	Siehe Abschnitt "Hinweise".

Siehe auch

RtlRealPredecessor

RtlSplay-

RtlSubtreeSuccessor