TSPI_lineSetAppSpecific, fonction (tspi.h)
La fonction TSPI_lineSetAppSpecific définit le champ spécifique à l’application de la structure LINECALLINFO de l’appel spécifié.
Syntaxe
LONG TSPIAPI TSPI_lineSetAppSpecific(
HDRVCALL hdCall,
DWORD dwAppSpecific
);
Paramètres
hdCall
Handle de l’appel dont le champ spécifique à l’application doit être défini. L’état d’appel de hdCall peut être n’importe quel état.
dwAppSpecific
Nouveau contenu du membre dwAppSpecific pour la structure LINECALLINFO de l’appel. Cette valeur n’est pas interprétée par le fournisseur de services. Ce paramètre n’est pas validé par TAPI lorsque cette fonction est appelée.
Valeur retournée
Retourne 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_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Remarques
Le champ spécifique à l’application dans la structure de données LINECALLINFO qui existe pour chaque appel n’est pas interprété par l’API Téléphonie ou l’un de ses fournisseurs de services. Son utilisation est entièrement définie par les applications. Le champ peut être lu à partir de l’enregistrement LINECALLINFO retourné par TSPI_lineGetCallInfo. Toutefois, TSPI_lineSetAppSpecific devez être utilisé pour définir le champ afin que les modifications deviennent visibles par d’autres applications. Lorsque ce champ est modifié, le fournisseur de services envoie un message LINE_CALLINFO avec une indication que le champ AppSpecific a changé.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |