lineUnpark, fonction (tapi.h)

La fonction lineUnpark récupère l’appel parqué à l’adresse spécifiée et retourne un handle d’appel pour celui-ci.

Syntaxe

LONG lineUnpark(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPHCALL lphCall,
  LPCSTR  lpszDestAddress
);

Paramètres

hLine

Gérez vers l’appareil de ligne ouverte sur lequel un appel doit être annulé.

dwAddressID

Adresse sur hLine à laquelle le dépark doit provenir. Un identificateur d’adresse est associé de manière permanente à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.

lphCall

Pointeur vers l’emplacement de type HCALL où le handle de l’appel nonparké est retourné. Ce handle n’est pas lié à tout autre handle qui a pu être précédemment associé à l’appel récupéré, tel que le handle qui a pu être associé à l’appel lors de son stationnement initial. L’application est le propriétaire unique initial de cet appel.

lpszDestAddress

Pointeur vers une mémoire tampon de caractères terminée par null qui contient l’adresse où l’appel est parqué. L’adresse est au format d’adresse de numérotation standard.

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 nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALADDRESS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	tapi.h
Bibliothèque	Tapi32.lib
DLL	Tapi32.dll

Voir aussi

LINE_REPLY

Fonctions de service de ligne supplémentaires

Vue d’ensemble de la référence TAPI 2.2