Sets new arguments for the call control function that immediately follows it.

DWORD briSetExtendedArgs (CTAHD ctahd,
void *extargs,
DWORD size)

ctahd CTA context handle returned by ctaCreateContext.

extargs Pointer to data structure containing extended arguments.

size Size of data structure extargs.

• SUCCESS
• CTAERR_BAD_SIZE
  size does not correspond to the extargs structures described in the Details section.
• CTAERR_INVALID_CTAHD

None.

This function sets additional arguments for the next call to briPlaceCall.

The arguments set by briSetExtendedArgs are only applicable to the next call. briSetExtendedArgs must be repeated for subsequent calls.

Refer to Chapter 4 for a detailed explanation of call control.

When sending UUI information, specify the protocol discriminator in byte 0 and the UUI data.

The arguments to be sent are stored in one of the following data structures:

/* Supplementary services called number extensions:             */
typedef struct
{
    char plan;         /* Called numbering plan                 */
    char type;         /* Called number type                    */
    char pad[2];       /* Pad                                   */
} BRI_CALLEDNUMBER;

/* Supplementary services calling number extensions:            */
typedef struct
{
    char digits[BRI_MAX_DIGITS+1];
       /* Calling address (33 char max)       */
    char plan;          /* Calling numbering plan              */
    char type;          /* Calling number type                 */
    char screen;        /* Calling no. screening indicator     */
    char presentation;  /* Calling number presentation         */
} BRI_CALLINGNUMBER;

/* Supplementary services place call extensions:               */
typedef struct
{
    DWORD size;         /* Size of structure                   */
    BRI_CALLEDNUMBER callednumber;   /* Called address         */
    BRI_CALLINGNUMBER callingnumber; /* Calling address        */
   DWORD  service;      /* Service. If the value is zero, the
        voice service will be used as the
        default                             */
    char  uui [BRI_MAX_UUI];  /* User-to-user info (132 chars max)*/
} BRIPLACECALL_EXTARGS;

briPlaceCall

    /* Declaration of the extended Place Call structure                                         */
      BRIPLACECALL_EXTARGS pc_extargs;

      if (sendUUI)  /* If we want to send UUI with the setup message               */
      {
        memset (&pc_extargs, 0, sizeof (pc_extargs));/* Clean it                       */
        strcpy (pc_extargs.callingnumber.digits, "5082711333");
           /* Specify calling no.  */
        pc_extargs.UUI[0] = BRI_UUI_IA5;
         strcpy (&pc_extargs.uui[1]           /* Specify the UUI     */
          "briswi - Natural MicroSystems call control: hello");
           /* Set structure in BRI*/
        briSetExtendedArgs (cx->ctahd, &pc_extargs, sizeof (pc_extargs));
      }
      /* Now place the call: the extended arguments will go with it                 */
      briPlaceCall( cx->ctahd, cx->dialstring, NULL );