Finds next object for any pipObjectFindFirst function.
Syntax
intl pipObjectFindNext ( pipObjectFile obj_h, pstr nameBuffer, intl
bufSize);
Arguments
obj_h The handle of the opened object file. Input.
nameBuffer A pointer to a buffer to be filled with the identifier of the object that is found. Output.
bufSize The size of the buffer that contains the identifier of the object that is found. If the buffer size is smaller than the identifier, the identifier is truncated. Input.
Return Value
PIP_ERROR PIP_IN_BORDER PIP_IN_BUFFER PIP_IN_POLYGON PIP_INPUT_IN_OBJECT
PIP_NOT_FOUND PIP_OBJECT_EQUALS_INPUT PIP_OBJECT_EQUALS_OUTPUT PIP_OBJECT_IN_INPUT
PIP_OK PIP_REGION_OVERLAP
Prerequisites
pipObjectFindFirstContaining, pipObjectFindFirstName, pipObjectFindFirstNearest, pipObjectFindFirstPolygon, or pipObjectFindFirstRect.
Alternates
None.
Notes
This function returns the identifier of a polygon or buffered area that contains a point. This point was identified by pipObjectFindFirstContaining, pipObjectFindFirstPolygon, or pipObjectFindFirstRect.
This function also returns the identifier of the object that matches the name pattern given by pipObjectFindFirstName.
If no additional objects are found, the function returns PIP_NOT_FOUND.