fonction linePrepareAddToConference (tapi.h)

Article
08/26/2023

La fonction linePrepareAddToConference prépare une téléconférence existante pour l’ajout d’une autre partie.

Syntaxe

LONG linePrepareAddToConference(
  HCALL                  hConfCall,
  LPHCALL                lphConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

Paramètres

hConfCall

Gérer à une téléconférence. L’application doit être propriétaire de cet appel. L’état de l’appel de hConfCall doit être connecté.

lphConsultCall

Pointeur vers un handle HCALL. Cet emplacement est ensuite chargé avec un handle identifiant l’appel de consultation à ajouter. Initialement, l’application est le seul propriétaire de cet appel.

lpCallParams

Pointeur vers une structure LINECALLPARAMS contenant des paramètres d’appel à utiliser lors de l’établissement de l’appel de consultation. Ce paramètre peut être défini sur NULL si aucun paramètre de configuration d’appel spécial n’est souhaité.

Valeur retournée

Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone, ou un numéro d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message LINE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_BEARERMODEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_CALLUNAVAIL, LINEERR_INVALRATE, LINEERR_CONFERENCEFULL, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_NOTOWNER, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALLINESTATE, LINEERR_USERUSERINFOTOOBIG, LINEERR_INVALMEDIAMODE, LINEERR_UNINITIALIZED.

Remarques

Si LINEERR_INVALLINESTATE est retourné, la ligne n’est actuellement pas dans un état dans lequel cette opération peut être effectuée. Vous trouverez la liste des opérations actuellement valides dans le membre dwLineFeatures (de type LINEFEATURE) de la structure LINEDEVSTATUS . (L’appel de lineGetLineDevStatus met à jour les informations dans LINEDEVSTATUS.)

Un handle de téléconférence peut être obtenu avec lineSetupConference ou avec lineCompleteTransfer qui est résolu en tant que conférence téléphonique triple. La fonction linePrepareAddToConference place généralement la téléconférence existante dans l’état onHoldPendingConference et crée un appel de consultation qui peut être ajouté ultérieurement à la téléconférence existante avec lineAddToConference.

L’appel de consultation peut être annulé à l’aide de lineDrop. Il peut également être possible pour une application d’échanger entre l’appel de consultation et la téléconférence tenue avec lineSwapHold.