fonction phoneConfigDialog (tapi.h)

La fonction phoneConfigDialog permet au fournisseur de l’appareil téléphonique spécifié d’afficher une boîte de dialogue modale (attachée au paramètre hwndOwner de l’application) qui permet à l’utilisateur de configurer les paramètres liés à l’appareil téléphonique spécifié par dwDeviceID.

Syntaxe

LONG phoneConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Paramètres

dwDeviceID

Identificateur de l’appareil téléphonique à configurer.

hwndOwner

Handle à une fenêtre à laquelle la boîte de dialogue doit être attachée. Peut être une valeur NULL pour indiquer que toute fenêtre créée pendant la fonction ne doit avoir aucune fenêtre propriétaire.

lpszDeviceClass

Pointeur vers une chaîne terminée par null qui identifie un nom de classe d’appareil. Cette classe d’appareil permet à l’application de sélectionner un sous-écran spécifique d’informations de configuration applicables à cette classe d’appareil. Ce paramètre est facultatif et peut être laissé NULL ou vide, auquel cas la configuration de niveau le plus élevé est sélectionnée.

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 :

PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Remarques

Le paramètre lpszDeviceClass permet à l’application de sélectionner un sous-écran spécifique d’informations de configuration applicables à la classe d’appareil qui intéresse l’utilisateur ; les chaînes autorisées sont les mêmes que pour phoneGetID. Par exemple, si le téléphone prend en charge l’API wave, le passage de « wave/in » en tant que lpszDeviceClass amène le fournisseur à afficher les paramètres liés spécifiquement à wave (ou au moins à démarrer au point correspondant dans une chaîne de boîte de dialogue de configuration à plusieurs niveaux, ce qui élimine la recherche de paramètres pertinents).

Le paramètre lpszDeviceClass doit être « tapi/phone », « » ou NULL pour que le fournisseur affiche la configuration de niveau le plus élevé pour le téléphone.

Configuration requise

Voir aussi

Fonctions de service téléphonique supplémentaires

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

phoneGetID