NWSMStr

Concatenates a specified number of strings together.

Syntax

  #include <smsutapi.h> 
   
  STRING NWSMStr ( 
     UINT8   n, 
     void   *dest, 
     void   *src1, 
     void   *src2, ...);

Parameters

n

(IN) Specifies the number of source strings to concatenate with dest.

dest

(OUT) Points to the concatenated strings (cannot be a NULL pointer).

src1

(IN) Points to the first string to concatenate.

src2

(IN) Points to the second string to concatenate.

...

(IN) Points to other strings to concatenate.

Return Values

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

NULL

Failure

Nonzero

The pointer points to dest.

Remarks

NOTE:This function is supported only for backward compatibility, the NWSMGenericStr function can be used instead of this, as it provides the same functionality.

dest must be large enough to hold all the strings.

See Also

NWSMCatStrings, NWSMFreeString