fonction lineRemoveFromConference (tapi.h)

Article
08/26/2023

La fonction lineRemoveFromConference supprime l’appel spécifié de la téléconférence à laquelle il appartient actuellement. Les appels restants de la téléconférence ne sont pas affectés.

Syntaxe

LONG lineRemoveFromConference(
  HCALL hCall
);

Paramètres

hCall

Gérez l’appel à supprimer de la conférence. L’application doit être propriétaire de cet appel. L’état de l’appel de hCall doit être conférencené.

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_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

Remarques

Cette opération supprime une partie qui appartient actuellement à une téléconférence. Une fois l’appel supprimé, il peut être possible de le manipuler davantage à l’aide de son handle. La disponibilité de cette opération et son résultat sont susceptibles d’être limités dans de nombreuses implémentations. Par exemple, dans de nombreuses implémentations, seule la partie la plus récemment ajoutée peut être supprimée d’une conférence et l’appel supprimé peut être automatiquement supprimé (devient inactif). Consultez les fonctionnalités de l’appareil de la ligne pour déterminer les effets disponibles de la suppression d’un appel d’une conférence.

Si la suppression d’un participant d’une conférence est prise en charge, l’appel du participant, après avoir été supprimé de la conférence, entre l’état de l’appel répertorié dans le membre dwRemoveFromConfState dans LINEADDRESSCAPS.