UdpNReceive

The procedure shown in Figure 1 notifies the TCP/IP address space that you are willing to receive UDP datagram data. This call returns immediately. The data buffer is not valid until you receive a UDPdatagramDELIVERED notification.

Figure 1. UdpNReceive example

   procedure UdpNReceive
            (
                 ConnIndex: ConnectionIndexType;
                 BufferAddress: integer;
                 BufferLength: integer;
        var    ReturnCode: CallReturnCodeType
            );
            external;

Parameter

Description

ConnIndex

The ConnIndex value returned from UdpOpen.

BufferAddress

The address of your buffer that is filled with a UDP datagram.

BufferLength

The length of your buffer. If you specify a length larger than 65507 bytes, only the first 65507 bytes are used.

ReturnCode

Indicates success or failure of a call. Possible return values are:

OK
ABNORMALcondition
FATALerror
NOsuchCONNECTION
NOTyetBEGUN
RECEIVEstillPENDING
TCPipSHUTDOWN
SOFTWAREerror
BADlengthARGUMENT
INVALIDvirtualADDRESS

For a description of Pascal return codes, see Table 1.