BWINext – Iterate to next item

BWINext (h, type, exist)

Use this to loop through information by moving to the next item of the type specified by the type parameter.

After calling this function you can use BWIGetValue and BWIGetString to access data associated with the item.

Handle containing the conditions, branches or search results to loop through.

type

Long integer. This is the type of data to iterate and can be one of:

BWI_N_BRANCH	If data for the country includes sub-branches, returns the next sub-branch. This clears all conditions set within the handle, so any conditions returned are for the next item.
BWI_N_NONE	Ends any existing iteration through conditions. When you next call BWINext the first condition of the specified severity will be returned.
BWI_N_SEARCH	Use this after performing a search using BWISearch to return the next search result. This clears all conditions set within the handle, so any conditions returned are for the next item.
BWI_N_SEVERITY	Where SEVERITY is FATAL, ERROR, WARNING or INFORMATION. Determines if there are any more conditions of the specified severity set within the handle. This does not clear the conditions set within the handle.
BWI_P_BRANCH	If data for the country includes sub-branches, returns the previous sub-branch. This clears all conditions set within the handle, so any conditions returned are for the next item.
BWI_P_SEARCH	Use this after performing a search using BWISearch to return the previous search result. This clears all conditions set within the handle, so any conditions returned are for the next item.

exist

Long integer. This is 1 if the item exists and 0 if it does not.