Functions which use input buffers must allocate the buffer and then initialize it to receive its type of information. The NWDSInitBuf function calls this the operation parameter, because it specifies the type of operation the function using the input buffer performs. These functions are called “Related Functions” in the table below.
The operation type is used both to initialize the buffer and to end an operation if the related function has an iterationHandle parameter. These functions have the potential of returning more information than can fit in an allocated output buffer. To end such an operation before the complete results have been retrieved, call NWDSCloseIteration with the operation type. This function frees the memory and states associated with the operation. The memory and states are automatically freed when all information is retrieved from an operation.