Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction linePickup récupère une alerte d’appel à l’adresse de destination spécifiée et retourne un handle d’appel pour l’appel récupéré. Si elle est appelée avec
Syntaxe
LONG linePickupA(
HLINE hLine,
DWORD dwAddressID,
LPHCALL lphCall,
LPCSTR lpszDestAddress,
LPCSTR lpszGroupID
);
Paramètres
hLine
Gérez l’appareil de ligne ouverte sur lequel un appel doit être récupéré.
dwAddressID
Adresse sur hLine à partir de laquelle le enlèvement doit provenir. Un identificateur d’adresse est associé définitivement à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.
lphCall
Pointeur vers un emplacement de mémoire où la poignée vers l’appel récupéré est retournée. L’application est le seul propriétaire initial de l’appel.
lpszDestAddress
Pointeur vers un mémoire tampon de caractères null-terminated qui contient l’adresse dont l’appel doit être récupéré. L’adresse est au format d’adresse rendez-vous standard.
lpszGroupID
Pointeur vers un mémoire tampon de caractères null-terminated contenant l’identificateur de groupe auquel appartient la station d’alerte. Ce paramètre est requis sur certains commutateurs pour récupérer des appels en dehors du groupe de prise en charge actuel.
Le paramètre lpszGroupID peut être spécifié par lui-même avec un pointeur NULL pour lpszDestAddress. Vous pouvez également spécifier lpszGroupID en plus de lpszDestAddress, si nécessaire par l’appareil.
Valeur de retour
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 de 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_INVALADDRESS, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALGROUPID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED.
Remarques
Lorsqu’un appel a été récupéré avec succès, l’application est avertie par le message LINE_CALLSTATE sur les modifications d’état des appels. La structure LINECALLINFO fournit des informations sur l’appel qui a été récupéré. Il répertorie la raison de l’appel comme . Cette structure est disponible à l’aide de lineGetCallInfo.
Si LINEADDRCAPFLAGS_PICKUPCALLWAIT est TRUE, linePickup peut être utilisé pour récupérer un appel pour lequel l’utilisateur a détecté le signal d’attente des appels, mais pour lequel le fournisseur ne peut pas effectuer la détection. Cela permet à l’utilisateur de « répondre » à un appel en attente, même si le fournisseur de services n’a pas pu détecter le signal d’attente d’appel. Les paramètres de pointeur lpszDestAddress et lpszGroupID doivent être NULL pour récupérer un appel en attente d’appel. La fonction linePickup
Une fois linePickup a été utilisé pour récupérer le deuxième appel, lineSwapHold peut être utilisé pour basculer entre eux. La fonction lineDrop peut être utilisée pour supprimer une (et basculer vers l’autre), etc. Si l’utilisateur souhaite supprimer l’appel actuel et récupérer le deuxième appel, il doit appeler lineDrop lorsqu’il reçoit le bip en attente d’appel, attendre le deuxième appel pour sonner, puis appeler lineAnswer sur le nouveau handle d’appel. L’indicateur LINEADDRFEATURE_PICKUP dans le membre dwAddressFeatures dans LINEADDRESSSTATUS indique quand l’enlèvement est réellement possible.
Note
L’en-tête tapi.h définit linePickup en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Windows |
| d’en-tête | tapi.h |
| bibliothèque | Tapi32.lib |
| DLL | Tapi32.dll |
Voir aussi
Vue d’ensemble de pickup
fonctions de service de ligne supplémentaires