ITLegacyAddressMediaControl2 ::ConfigDialogEdit, méthode (tapi3if.h)
La méthode ConfigDialogEdit permet au fournisseur de l’appareil de ligne spécifié d’afficher une boîte de dialogue pour permettre à l’utilisateur de configurer des paramètres liés à l’appareil de ligne. Les données de configuration sont transmises dans et hors de cette méthode par l’application. (Les données sont identiques à celles récupérées par la méthode ITLegacyAddressMediaControl ::GetDevConfig et définies par la méthode ITLegacyAddressMediaControl ::SetDevConfig .)
Syntaxe
HRESULT ConfigDialogEdit(
[in] HWND hwndOwner,
[in] BSTR pDeviceClass,
[in] DWORD dwSizeIn,
[in] BYTE *pDeviceConfigIn,
[out] DWORD *pdwSizeOut,
[out] BYTE **ppDeviceConfigOut
);
Paramètres
[in] hwndOwner
Handle à une fenêtre à laquelle la boîte de dialogue doit être attachée. Peut être NULL pour indiquer qu’une fenêtre créée par la méthode ne doit avoir aucune fenêtre propriétaire.
[in] pDeviceClass
Pointeur vers un BSTR qui spécifie 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.
[in] dwSizeIn
Pointeur vers la taille des données de configuration pointées vers le paramètre pDeviceConfigIn .
[in] pDeviceConfigIn
Pointeur vers un tableau d’octets contenant des données de configuration d’appareil à modifier.
[out] pdwSizeOut
Pointeur vers la taille des données de configuration pointées vers le paramètre ppDeviceConfigOut .
[out] ppDeviceConfigOut
Pointeur vers un tableau d’octets contenant des données de configuration d’appareil modifiées.
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Cette méthode se traduit par un TAPI 2. xlineConfigDialogEdit call. La méthode ITLegacyAddressMediaControl2 ::ConfigDialog se traduit par un appel lineConfigDialog . Ces méthodes diffèrent par leur source de paramètres à modifier et le résultat de la modification sur une connexion active. Pour une discussion sur ces différences, consultez lineConfigDialogEdit.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi3if.h |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |