TSPI_lineRemoveFromConference, fonction (tspi.h)

Article
08/26/2023

La fonction TSPI_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 TSPIAPI TSPI_lineRemoveFromConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdCall

Handle de l’appel à supprimer de la conférence. L’état de l’appel de hdCall peut être conférencené.

Valeur retournée

Retourne dwRequestID, ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult de la ASYNC_COMPLETION correspondante est égal à zéro si la fonction réussit, ou un numéro d’erreur 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.

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). Le fournisseur de services indique ses fonctionnalités dans LINEDEVCAPS en ce qui concerne 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, le fournisseur de services doit indiquer dans le membre dwRemoveFromConfState dans LINEADDRESSCAPS l’état de l’appel vers lequel l’appel passe après sa suppression de la conférence.