TSPI_lineUnpark, fonction (tspi.h)
La fonction TSPI_lineUnpark récupère l’appel parqué à l’adresse spécifiée et retourne un handle d’appel pour celui-ci.
Syntaxe
LONG TSPIAPI TSPI_lineUnpark(
DRV_REQUESTID dwRequestID,
HDRVLINE hdLine,
DWORD dwAddressID,
HTAPICALL htCall,
LPHDRVCALL lphdCall,
LPCWSTR lpszDestAddress
);
Paramètres
dwRequestID
Identificateur de la requête asynchrone.
hdLine
Handle de la ligne sur laquelle un appel doit être annulé.
dwAddressID
Adresse sur hdLine à laquelle provient le dépark. 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. TAPI ne valide pas ce paramètre lorsque cette fonction est appelée.
htCall
Handle TAPI pour le nouvel appel sans parking. Le fournisseur de services doit l’enregistrer et l’utiliser dans tous les appels suivants à la procédure LINEEVENT rapportant des événements sur l’appel.
lphdCall
Pointeur vers un HDRVCALL représentant l’identificateur du fournisseur de services pour le nouvel appel non affecté. Le fournisseur de services doit remplir cet emplacement avec son handle pour l’appel avant que cette procédure ne retourne. Ce handle n’est pas valide si la fonction génère une erreur.
lpszDestAddress
Pointeur vers une chaîne Unicode terminée par null qui contient l’adresse où l’appel est parqué. L’adresse est au format d’adresse accessible.
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_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL.
Remarques
Cette fonction diffère de la fonction TAPI correspondante en ce qu’elle suit le modèle TSPI pour commencer la durée de vie d’un appel. TAPI et le fournisseur de services échangent des handles opaques représentant l’appel entre eux. En outre, le fournisseur de services est autorisé à effectuer des rappels pour le nouvel appel avant qu’il ne revienne de cette procédure. Dans tous les cas, le fournisseur de services doit également traiter le handle qu’il a retourné comme « non encore valide » jusqu’à ce que le message de ASYNC_COMPLETION correspondant signale la réussite. En d’autres termes, il ne doit pas émettre de messages LINEEVENT pour le nouvel appel ou l’inclure dans le nombre d’appels dans les messages ou status structures de données pour la ligne.
Le handle d’appel créé par cette fonction est un nouveau handle d’appel distinct, même si un handle d’appel d’origine pour l’appel existe toujours (il n’a pas été détruit par TSPI_lineCloseCall).
Configuration requise
| Plateforme cible | Windows |
| En-tête | tspi.h |