NWSMGetNextName

Continues the data set name parsing process started by calling NWSMGetFirstName .

Syntax

  #include <smsutapi.h> 
   
  CCODE NWSMGetNextName( 
     SMS_HANDLE SM_HUGE           *handle, 
     NWSM_DATA_SET_NAME SM_HUGE  *name);

Parameters

handle

(IN) Points to the name handle returned by NWSMGetFirstName.

name

(OUT) Points to the data set name information.

Return Values

The following table lists the return values associated with the function.

0x00000000

Successful

0xFFFBFFFD

NWSMUT_INVALID_PARAMETER

0xFFFBFFFF

NWSMUT_INVALID_HANDLE

0xFFFBFFFC

NWSMUT_NO_MORE_NAMES

Remarks

NWSMGetNextName returns the next name contained in buffer.

To close handle, call NWSMCloseName. handle is automatically closed when NWSMGetNextName returns NWSMUT_NO_MORE_NAMES.

See Also

NWSMCloseName, NWSMGetFirstName

NWSMGetNextName Example

  #include <smsutapi.h> 
   
  CCODE ccode; 
  UINT32 HUGE handle 
  NWSM_DATA_SET_NAME HUGE name; 
  NWSM_DATA_SET_NAME_LIST *dataSetList; 
  void HUGE *buffer; 
   
  buffer = dataSetList; 
  if ((ccode = NWSMGetFirstName(buffer, &name, &handle)) == 0) 
  { 
     while ((ccode = NWSMGetNextName(&handle, &name)) == 0) 
     { 
        ... 
     } 
  } 
  if (!ccode) 
     NWSMCloseName(&handle);