sbpurcvx

The sbpurcvx function processes Open responses from a routing procedure. An application can define a routing procedure that is called by the DMOD when a message is received. This routing procedure should first call sbpurcvx to handle any Open response messages received. This ensures that Open responses intended for the Resource Locator are handled correctly.

Win32

USHORT sbpurcvx(

BUFHDR * *msgptr,
INTEGER locl,
INTEGER retstat
);

MS-DOS, Windows Version 3.x, and OS/2

USHORT FAR sbpurcvx(

BUFHDR FAR * FAR *msgptr,
INTEGER locl,
INTEGER retstat
);

Parameters

msgptr

Pointer to the message returned by the DMOD to the routing procedure.

locl

Locality from which message was received (if retstat indicates message returned), or locality to which path was lost (if retstat indicates path error).

retstat

Reason for call:

CEDINMSG (1—message returned.

CEDINLLN (2)—path error.

Return Values

TRUE: The Resource Locator has accepted the message; the application should not process it any further.
FALSE: The message should be processed by the application.

Remarks

This function is called by a routing procedure that is called by the DMOD; it is not called directly by the application.

The parameters for sbpurcvx should be taken from the parameters for routproc. Note, however, that the first parameter to sbpurcvx is a pointer to a pointer to a buffer header (that is, a pointer to the corresponding parameter for the routing procedure, not the parameter itself).