lineSetAppSpecific, fonction (tapi.h)

Article
03/09/2024

La fonction lineSetAppSpecific permet à une application de définir le champ spécifique à l’application de l’enregistrement d’informations d’appel de l’appel spécifié.

Syntaxe

LONG lineSetAppSpecific(
  HCALL hCall,
  DWORD dwAppSpecific
);

Paramètres

hCall

Gérez l’appel dont le champ spécifique à l’application doit être défini. L’application doit être propriétaire de l’appel. L’état d’appel de hCall 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 l’API Téléphonie.

Valeur retournée

Retourne zéro si la demande réussit ou un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED.

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 lineGetCallInfo. Toutefois, lineSetAppSpecific doit être utilisé pour définir le champ afin que les modifications deviennent visibles par d’autres applications. Lorsque ce champ est modifié, toutes les autres applications avec des descripteurs d’appel reçoivent un message LINE_CALLINFO indiquant que le membre dwAppSpecific a changé.