fonction lineConfigDialog (tapi.h)

La fonction lineConfigDialog permet au fournisseur de l’appareil de ligne spécifié d’afficher une boîte de dialogue (attachée à hwndOwner de l’application) pour permettre à l’utilisateur de configurer des paramètres liés à l’appareil de ligne.

Syntaxe

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

Paramètres

dwDeviceID

Identificateur de l’appareil de ligne à configurer.

hwndOwner

Gérer à une fenêtre à laquelle la boîte de dialogue doit être attachée. Peut avoir la 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 requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPARAM, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Remarques

La fonction lineConfigDialog permet au fournisseur de services d’afficher une boîte de dialogue modale (attachée à hwndOwner de l’application) pour permettre à l’utilisateur de configurer les paramètres liés à la ligne spécifiée par dwDeviceID. Le paramètre lpszDeviceClass permet à l’application de sélectionner un sous-écran spécifique d’informations de configuration applicable à la classe d’appareil qui intéresse l’utilisateur ; les chaînes autorisées sont les mêmes que pour lineGetID. Par exemple, si la ligne prend en charge l’API Comm, la transmission de « COMM » en tant que lpszDeviceClass amène le fournisseur à afficher les paramètres liés spécifiquement à Comm (ou, au moins, à démarrer au point correspondant d’une chaîne de boîte de dialogue de configuration à plusieurs niveaux, de sorte que l’utilisateur n’a pas à « creuser » pour trouver les paramètres qui vous intéressent).

Le paramètre lpszDeviceClass est « tapi/line », « » ou NULL pour que le fournisseur affiche la configuration de niveau le plus élevé pour la ligne.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	tapi.h
Bibliothèque	Tapi32.lib
DLL	Tapi32.dll

Voir aussi

Informations de référence sur les services de téléphonie de base

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

lineGetID