FindPropertyInstanceRestart

The FindPropertyInstanceRestart function finds the next instance of the property specified by the hProperty parameter.

LPPROPERTYINST WINAPIFindPropertyInstanceRestart(HFRAMEhFrame,
HPROPERTYhProperty,
LPPROPERTYINST*lpRestartKey,
BOOLDirForward);

Parameters

• hFrame
  [in] A handle to the frame. The frame handle can be retrieved by a call to the GetFrame function.

• hProperty
  [in] A handle to the property to find. The property handle can be retrieved by a call to the GetProperty function.

• lpRestartKey
  [in] A pointer to the property instance used as the starting point of the search. If the lpRestartKey parameter is set to NULL, the search begins at beginning of the frame, or the end of the frame, depending on the value of the DirForward parameter.

  If lpRestartKey points to NULL, the search begins at the beginning of the frame if DirForward is TRUE or the at end of the frame if the parameter is FALSE.

• DirForward
  [in] An indicator of the search direction. If the value is TRUE, the search moves from the current location to the end of the frame. If the value is FALSE, the search moves from the current location to the beginning of the frame.

Return Values

If the function is successful, the return value is the next valid LPPROPERTYINST.

If the function is unsuccessful, the return value is NULL.

Remarks

Experts and parsers can call the FindPropertyInstanceRestart function.

Requirements

See Also

GetFrame, GetProperty