[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 SWPSETSTR() / SWPSETSTRBAS()  Set string to return to parent process.
------------------------------------------------------------------------------

 Function : Set a string to return to the parent process.

 Syntax   : niValue = SWPSETSTR(cPID, cString)

 Return   : A logical value

 SWPSETSTR() 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 := SWPSETSTR("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

See Also: SWPADDSTR() SWPGETPID() SWPGETSTR() SWPSETPID()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson