2.3 Retrieving and Unpacking Object, Attribute, and Value Data

The following procedure explains how to retrieve data from a call to NWDSItrGetNext or NWDSItrGetPrev function when the information type of the iterator object consists of attribute names and values. If your result buffer is not big enough to hold all the requested data, you must retrieve the data and then repeat the call to retrieve the next set of data.

  1. Call NWDSAllocBuf to allocate the result buffer, which does not need to be initialized.

  2. Call NWDSItrGetNext or NWDSItrGetPrev.

  3. Call NWDSGetObjectCount to determine the number of objects whose information is stored in the buffer.

  4. Call NWDSGetObjectName to get the name of the current object in the buffer and the count of attributes associated with the object.

  5. Call NWDSGetAttrName to retrieve the name of the attribute and the count of values associated with the attribute.

  6. For each value associated with the attribute, call NWDSGetAttrVal to retrieve the value.

  7. Loop through Steps 5 and 6 until all attribute information for the object has been read.

  8. Loop to Step 4 until the information for all objects in the buffer has been retrieved.

  9. If the result buffer does not contain all the requested data, loop to Step 2 and call the request function again (either NWDSItrGetNext or NWDSItrGetPrev).

    If the result buffer contains all the requested data, continue with Step 10.

  10. Call NWDSFreeBuf to free the result buffer.

  11. Call NWDSItrDestroy to destroy the iterator object.

You must pull all information from the result buffer even if you do not plan to use it. There is no way to skip data.

See Also