NWSMAppendToList

Appends an element to NWSM_LIST list.

Syntax

  #include <smsutapi.h> 
   
  NWSM_LIST *NWSMAppendToList ( 
     NWSM_LIST_PTR  *listPtr, 
     BUFFERPTR         text, 
     void             *otherInfo); 
  
  

Parameters

listPtr

(IN) Points to the list to append (cannot be a NULL pointer).

text

(IN) Points to the text information to be added to a new element.

otherInfo

(IN) Points to the buffer containing information associated with text (optional).

Return Values

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

Nonzero

Successful, returns a pointer to the appended element.

NULL

Out of memory

Remarks

NWSMAppendToList creates an element, copies text to the element, attaches otherInfo to the element, and appends the element to the end of the list.

NWSMAppendToList assumes that list is valid.

listPtr was initialized by NWSMInitList.

See Also

NWSMDestroyList, NWSMInitList