SWPADDSTR() / SWPADDSTRBAS()  Return string to previous parent program
------------------------------------------------------------------------------

 Function : Return a string to a previous parent program

 Syntax   : niValue = SWPADDSTR(cPID, cString)

 Return   : A logical value

 SWPADDSTR() can be used to return a string of up to 127 bytes from the child
 program to a parent. The string to be returned may not contain any NULLs, -
 the first NULL will be interpreted as a string terminator.

 The parent to receive the string is identified using the program ID of the
 parent program (set in the parent using SWPSETPID()). The string may be
 retrieved by the parent program using SWPGETSTR().

 Example :

    success := SWPADDSTR("TEST","OK")

 returns the string "OK" to the program that has set a program ID of "TEST".

 The return value is a logical indicating success or failure. There are three
 possible reasons for failure:

    1 - the named parent program kernel is not currently in memory
    2 - the string to be returned is longer than 127 bytes
    3 - the parent was linked with a version of Blinker prior to 2.10