FindPropertyInstanceRestart-Funktion

Artikel
06/13/2023

Die FindPropertyInstanceRestart-Funktion findet den nächsten instance der eigenschaft, die durch den hProperty-Parameter angegeben wird.

Syntax

LPPROPERTYINST WINAPI FindPropertyInstanceRestart(
  _In_ HFRAME         hFrame,
  _In_ HPROPERTY      hProperty,
  _In_ LPPROPERTYINST *lpRestartKey,
  _In_ BOOL           DirForward
);

Parameter

hFrame [in]

Ein Handle für den Frame. Das Framehandle kann durch einen Aufruf der GetFrame-Funktion abgerufen werden.

hProperty [in]

Ein Handle für die zu findende Eigenschaft. Das Eigenschaftenhandle kann durch einen Aufruf der GetProperty-Funktion abgerufen werden.

lpRestartKey [in]

Ein Zeiger auf die Eigenschaft instance als Ausgangspunkt der Suche verwendet. Wenn der lpRestartKey-Parameter auf NULL festgelegt ist, beginnt die Suche am Anfang des Frames oder am Ende des Frames, abhängig vom Wert des DirForward-Parameters .

Wenn lpRestartKey auf NULL zeigt, beginnt die Suche am Anfang des Frames, wenn DirForwardTRUE ist, oder am Ende des Frames, wenn der Parameter FALSE ist.

DirForward [in]

Ein Indikator für die Suchrichtung. Wenn der Wert TRUE ist, wird die Suche vom aktuellen Speicherort an das Ende des Frames verschoben. Wenn der Wert FALSE ist, wird die Suche vom aktuellen Speicherort an den Anfang des Frames verschoben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der nächste gültige LPPROPERTYINST.

Wenn die Funktion nicht erfolgreich ist, ist der Rückgabewert NULL.

Bemerkungen

Experten und Parser können die FindPropertyInstanceRestart-Funktion aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Netmon.h
Bibliothek	Nmapi.lib
DLL	Nmapi.dll

Siehe auch

Getframe
GetProperty

Freigeben über