Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction linePrepareAddToConference prépare une téléconférence existante pour l’ajout d’un autre tiers.
Syntaxe
LONG linePrepareAddToConferenceA(
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 d’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 de retour
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 de 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
Un handle d’appel de conférence peut être obtenu avec lineSetupConference ou avec lineCompleteTransfer résolu en tant qu’appel de conférence tridirectionnel. 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 à l’appel de conférence existant avec lineAddToConference.
L’appel de consultation peut être annulé à l’aide de lineDrop. Il peut également être possible qu’une demande échange entre l’appel de consultation et la téléconférence tenue avec lineSwapHold.
Note
L’en-tête tapi.h définit linePrepareAddToConference en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | tapi.h |
| bibliothèque | Tapi32.lib |
| DLL | Tapi32.dll |
Voir aussi
Vue d’ensemble de la conférence