srv_sendpassthru

Description

Send a protocol packet to a client.

Syntax

CS_RETCODE srv_sendpassthru(spp, send_bufp, infop)

SRV_PROC      *spp;
CS_BYTE         *send_bufp;
CS_INT           *infop;

Parameters

Returns

Examples

Example 1

#include    <stdio.h>

#include    <ospublic.h>

/*

** Local Prototype.

*/

CS_RETCODE      ex_srv_sendpassthru PROTOTYPE((

SRV_PROC        *spp

));

/* 

** EX_SRV_SENDPASSTHRU

**

**  Example routine to send a protocol packet to a client.

**

** Arguments:

**  spp  A pointer to an internal thread control structure.

**

** Returns:

**

**  CS_SUCCEED 

**  CS_FAIL

*/

CS_RETCODE      ex_srv_sendpassthru(spp)

SRV_PROC        *spp;

{

      CS_BYTE    sendbuf[20];

      CS_INT     info;

      strcpy(sendbuf, “Here’s what to send”);

      if (srv_sendpassthru(spp, sendbuf, &info) == CS_FAIL)

      {

            return(CS_FAIL);

      }

      else

      {

            if (info == SRV_I_PASSTHRU_MORE)

            {

                printf(“more to come...\n”);

                return(CS_SUCCEED);

            }

            else if (info == SRV_I_PASSTHRU_EOM)

            {

                printf(“That’s all.\n”);

                return(CS_SUCCEED);

            }

            else

            {

                printf(“Unknown flag returned.\n”);

                return(CS_FAIL);

            }

      }

}

Usage

• srv_sendpassthru sends a protocol packet received from a client program or Adaptive Server Enterprise without interpreting its contents.

• srv_sendpassthru performs byte ordering on protocol header fields.

• Once called, the thread that called it is in passthrough mode. Passthrough mode ends when the SRV_PASSTHRU_EOM is returned.

• No other Server-Library routines can be called while the event handler is in passthrough mode.

• To use passthrough mode, the SRV_CONNECT handler for the client must allow the client and remote server to negotiate the protocol format by calling srv_getloginfo, ct_setloginfo, ct_getloginfo, and srv_setloginfo. This allows clients and remote servers running on dissimilar platforms to perform any necessary data conversions.

• srv_sendpassthru can be used in all event handlers except SRV_CONNECT, SRV_DISCONNECT, SRV_START, SRV_STOP, SRV_URGDISCONNECT, and SRV_ATTENTION.

See also