NWSMTSCatDataSetName

Syntax

  #include <smstsapi.h> 
   
  CCODE NWSMTSCatDataSetName (
     UINT32          connection, 
     UINT32          nameSpaceType, 
     STRING          dataSetName, 
     STRING          terminalName, 
     NWBOOLEAN       terminalNameIsParent, 
     STRING_BUFFER **newDataSetName);
  

Parameters

connection

(IN) Specifies the connection information returned by NWSMTSConnectToTargetService or NWSMTSConnectToTargetServiceEx.

nameSpaceType

(IN) Specifies the name space type of the names to concatenate (see nameSpaceType Values).

dataSetName

(IN) Specifies the data set name to append to.

terminalName

(IN) Specifies the data set's name (parent or child name only) to append to dataSetName.

terminalNameIsParent

(IN) Specifies if terminalName is a parent or child:

• TRUE Parameter specifies a parent
• FALSE Parameter specifies a child

newDataSetName

(OUT) Points to the concatenated path.

Return Values

See Section 9.3, Target Service Return Values for more information.

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

Remarks

NWSMTSCatDataSetName appends a terminal name onto an existing path. If terminalName is a parent, the appropriate delimiter for that namespace is appended to the end of the string. If terminalName is a parent, and if the Target Service requires it, a separator is placed at the end of newDataSetName.

newDataSetName must point to a valid structure or NULL. NWSMTSCatDataSetName allocates memory if NULL is passed, or allocates a larger memory block if the structure does not have enough space.

The engine should call NWSMFreeString to deallocate newDataSetName .