Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper Tools . Book 4-Appendices - <b>ppcwrite()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 PPCWRITE()
 Writes data to a communication sending buffer
------------------------------------------------------------------------------
 Syntax

     PPCWRITE(<nHandle>,<cData>) --> nLength

     Netware: 2.2 and 3.11

 Arguments

     <nHandle>  Designates the communication buffer.

     <cData>  Designates a character string that contains the data that
     is written to the sending buffer.

 Returns

     PPCWRITE() returns the number of characters that could not be written to
     the sending buffer.  Therefore, a return value larger than 0 indicates
     an error (for example, when the sending buffer is full).

 Description

     PPCWRITE() allows you to write data into the sending buffer of a
     communication buffer, independently of the protocol used (IPX, SPX,
     NetBIOS datagram, or NetBIOS session).  The parameter <nHandle> contains
     the handle of the communication buffer.  The data must be passed as a
     character string (<cData>).  PPCWRITE() transmits the data to the
     sending buffer.  The data is sent from the sending buffer, in an
     interrupt controlled transmission in the background.  If the sending
     buffer does not have enough memory to accept all the characters,
     PPCWRITE() returns the number of characters that could not be
     transmitted to the sending buffer.

 Examples

     .  Open the IPX sending buffer for a broadcast message, and send
        the message "Good morning!":

        nHandle=IPXOPEN(20000,,546,'FFFFFFFFFFFFFFFFFFFF')
        PPCWRITE(nHandle,'Good morning!')

     .  Send data from the character string <cData>, and take into
        account that the sending buffer might be full:

        nRest=LEN(cData)
        WHILE nRest>0
           nRest = PPCWRITE(nHandle,RIGHT(cData,nRest))
        ENDDO

See Also: PPCREAD() PPCSNDCNT()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson