wpclsFindObjectNext returns object pointers (up to the number requested in pulCount) for as many objects that match the specifications and that fit in pBuffer. On output, pulCount contains the actual number of object pointers returned.

wpclsFindObjectNext uses the find object handle associated with wpclsFindObjectFirst to continue the search started by the wpclsFindObjectFirst request.

If wpclsFindObjectNext returns FALSE, the wpQueryError method can be called to retrieve the error code. Error codes include:

WPERR_OBJECT_NOT_FOUND

No objects matching the specified criteria were found.
WPERR_BUFFER_OVERFLOW
The pBuffer buffer was not large enough to fit all objects matching the specified criteria. The wpclsFindObjectNext method should be called to retrieve the rest of the objects matching the specified criteria.

The wpclsFindObjectEnd method should be called to terminate the find operation.

---

[Back] [Next]