TSPI_lineHold, fonction (tspi.h)

Article
08/26/2023

La fonction TSPI_lineHold met l’appel spécifié en attente.

Syntaxe

LONG TSPIAPI TSPI_lineHold(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdCall

Le handle du fournisseur de services pour l’appel à mettre en attente. L’état d’appel de hdCall peut être connecté.

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

L’appel en attente est temporairement déconnecté, ce qui permet à TAPI d’utiliser l’appareil de ligne pour passer ou répondre à d’autres appels. TSPI_lineHold effectue une conservation dure de l’appel spécifié, par opposition à un appel de consultation. Un appel en attente dure ne peut généralement pas être transféré ou inclus dans une téléconférence, contrairement à un appel de consultation. Les appels de consultation sont lancés à l’aide de TSPI_lineSetupTransfer, de TSPI_lineSetupConference ou de TSPI_linePrepareAddToConference.

Une fois qu’un appel est correctement mis en attente, l’état de l’appel passe généralement à onHold. Un appel retenu est récupéré via TSPI_lineUnhold. Lorsqu’un appel est en attente, le fournisseur de services peut envoyer LINE_CALLSTATE messages sur les changements d’état de l’appel retenu. Par exemple, si la partie retenue raccroche, l’état de l’appel peut passer à déconnecté et le fournisseur de services peut envoyer un message LINE_CALLSTATE indiquant le nouvel état.