Click above to get retro games delivered to your door ever month!

This function was formerly named N_RECV(). Calls to N_RECV() will not
produce an error with the current version of NetLib, but you should
begin using N_RECV() in new code and update existing code when
convenient. In addition, the old functions N_CONN() and N_DISC() are no
longer needed. We recommend you remove calls to those functions from
existing code.


Syntax

N_GETPIPE( @<nSource>, @<cMessage> )


Parameters

<nSource>
Memory variable to receive the station number that is the source of the 
message. It must be passed by reference (that is, prefixed with @).

<cMessage>
Memory variable to receive the text of the message. It must be passed 
by reference (that is, prefixed with @).


Returns

Logical true if a message has been received. False if no message, in 
which case the memory variables are unchanged.


Description

A pending "piped" message is stored in the memory variable passed as 
the second argument, while the originating station number is stored in 
the first memory variable. Both memory variables need to be initialized 
prior to calling the function, but their data types and values are 
unimportant since the function will modify them as required.

Note  "Piped" messages are not supported by NetWare 386.


Example

// Check for messages and display one
STORE .F. to nStanum, cMsg
IF N_GETPIPE(@nStanum, @cMsg)
   @ 1, 0 CLEAR TO 2, 79
   where = STR(nStanum, 2)
   who = N_WHOAMI(nStanum)
   @ 1, 0 SAY 'Message from &who (station &where): ' + cMsg
ENDIF