TSPI_linePark, fonction (tspi.h)

Article
03/09/2024

La fonction TSPI_linePark parcs l’appel spécifié en fonction du mode de parc spécifié.

Syntaxe

LONG TSPIAPI TSPI_linePark(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  DWORD         dwParkMode,
  LPCWSTR       lpszDirAddress,
  LPVARSTRING   lpNonDirAddress
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdCall

Poignée à l’appel à stationner. L’état d’appel de hdCall peut être connecté.

dwParkMode

Le mode de parc avec lequel l’appel doit être garé, une seule des constantes LINEPARKMODE_.

lpszDirAddress

Pointeur vers une chaîne Unicode terminée par null qui indique l’adresse où l’appel doit être parqué lors de l’utilisation du parc dirigé. L’adresse est au format d’adresse accessible. Ce paramètre est ignoré pour le parc non dirigé.

lpNonDirAddress

Pointeur vers une structure de type VARSTRING. Pour le parc non dirigé, l’adresse où l’appel est parqué est retournée dans cette structure. Ce paramètre est ignoré pour le parc dirigé. Dans la structure VARSTRING , dwStringFormat doit être défini sur STRINGFORMAT_ASCII (une mémoire tampon de chaîne ASCII contenant une chaîne terminée par null), et la valeur NULL de fin est prise en compte dans dwStringSize. Si la mémoire pointée par le paramètre lpNonDirAddress n’est pas suffisamment grande pour l’adresse demandée, la fonction TSPI_linePark retourne LINEERR_STRUCTURETOOSMALL.

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_NOMEM, LINEERR_INVALPARKMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL.

Remarques

Tous les membres de la structure VARSTRING , à l’exception de dwTotalSize, sont renseignés par le fournisseur de services. Le membre dwTotalSize est renseigné par TAPI et le fournisseur de services ne doit pas remplacer cette valeur.

Sous parc dirigé, l’application cliente (via TAPI) spécifie l’adresse à laquelle elle souhaite parquer l’appel. Sous parc non dirigé, le commutateur détermine l’adresse et la fournit à TAPI. Dans les deux cas, un appel parqué peut être annulé en spécifiant cette adresse.

L’appel parqué passe généralement à l’état d’appel inactif une fois qu’il a été correctement garé. Le fournisseur de services signale le nouvel état à l’aide d’un message LINE_CALLSTATE . Une TSPI_lineUnpark suivante crée un nouveau handle d’appel distinct, que TSPI_lineCloseCall ait ou non détruit l’ancien handle.

Certains commutateurs peuvent rappeler à l’utilisateur une fois qu’un appel a été garé pendant un certain temps. Le fournisseur de services signale cela à TAPI en tant qu’appel d’offre avec une raison d’appel définie sur rappel (si cela est connu).