Interface IFaxRoutingMethod (faxcom.h)

L’interface double IFaxRoutingMethod est utilisée par une application cliente de télécopie pour récupérer les informations de configuration de routage de télécopie pour un port de télécopie sur un serveur de télécopie connecté. Un objet FaxRoutingMethods est une collection d’objets FaxRoutingMethod .

L’interface IFaxRoutingMethod inclut les méthodes d’interface suivantes.

• Méthodes de propriété pour récupérer, activer ou désactiver une méthode de routage de télécopie pour un objet FaxPort spécifique. (Les méthodes de routage par télécopie sont définies par des DLL d’extension de routage de télécopie.)
• Méthodes de propriété pour récupérer les attributs d’un objet FaxRoutingMethod , comme le nom de la DLL qui exporte la méthode de routage. Les attributs incluent également le GUID et le nom de la fonction qui identifient de manière unique la méthode de routage, ainsi que le nom convivial de la méthode de routage.

Une méthode de routage est une action qui est effectuée chaque fois qu’une télécopie est reçue sur un port. Si la réception de télécopie n’est pas activée sur un port, le service de télécopie ignore les méthodes de routage associées au port. Seules les méthodes de routage activées sont exécutées lors de la réception d’une télécopie.

Héritage

L’interface IFaxRoutingMethod hérite de l’interface IDispatch.

Méthodes

L’interface IFaxRoutingMethod a ces méthodes.

IFaxRoutingMethod::get_DeviceId La propriété IFaxRoutingMethod::get_DeviceId est un nombre représentant l’identificateur de ligne du port de télécopie.
IFaxRoutingMethod::get_DeviceName La propriété IFaxRoutingMethod::get_DeviceName est une chaîne terminée par null qui contient le nom complet convivial d’un port de télécopie.
IFaxRoutingMethod::get_Enable La propriété IFaxRoutingMethod::get_Enable est une valeur booléenne qui indique si une méthode de routage de télécopie est activée sur un port de télécopie particulier. (Get)
IFaxRoutingMethod::get_ExtensionName La propriété IFaxRoutingMethod::get_ExtensionName est une chaîne terminée par null qui contient le nom convivial de la DLL d’extension de routage de télécopie qui implémente la méthode de routage de télécopie spécifiée.
IFaxRoutingMethod::get_FriendlyName La propriété IFaxRoutingMethod::get_FriendlyName est une chaîne terminée par null qui contient le nom convivial d’une méthode de routage de télécopie.
IFaxRoutingMethod::get_FunctionName La propriété IFaxRoutingMethod::get_FunctionName est une chaîne terminée par null qui contient le nom de la fonction qui exécute une procédure de routage de télécopie spécifique.
IFaxRoutingMethod::get_Guid La propriété IFaxRoutingMethod::get_Guid est une chaîne terminée par null qui contient le GUID qui identifie de manière unique la méthode de routage de télécopie.
IFaxRoutingMethod::get_ImageName La propriété IFaxRoutingMethod::get_ImageName est une chaîne terminée par une valeur Null qui contient le nom de l’image exécutable de la DLL d’extension de routage de télécopie qui implémente la méthode de routage de télécopie.
IFaxRoutingMethod::get_RoutingData La propriété IFaxRoutingMethod::get_RoutingData est une chaîne terminée par null qui contient la chaîne de routage d’une transmission de télécopie entrante.
IFaxRoutingMethod::p ut_Enable La propriété IFaxRoutingMethod::get_Enable est une valeur booléenne qui indique si une méthode de routage de télécopie est activée sur un port de télécopie particulier. (Put)

Notes

Quand implémenter

Vous ne devez pas implémenter cette interface. L’implémentation standard de Microsoft fournit des fonctionnalités complètes.

Quand utiliser

Utilisez l’interface IFaxRoutingMethod pour activer ou désactiver une méthode de routage de télécopie sur un port de télécopie spécifique, et pour récupérer et définir les propriétés d’un objet FaxRoutingMethod . Il existe un objet FaxRoutingMethod pour chaque méthode de routage associée au port de télécopie spécifié.

Une application cliente ne doit pas appeler la fonction CoCreateInstance pour récupérer un pointeur d’interface IFaxRoutingMethod . Au lieu de cela, l’application doit effectuer les étapes suivantes pour créer une instance d’un objet FaxRoutingMethod .

1. Appelez la fonction CoCreateInstance pour récupérer un pointeur vers une interface IFaxServer .
2. Appelez la méthode IFaxServer::Connect pour vous connecter à un serveur de télécopie actif.
3. Appelez la méthode IFaxServer::GetPorts pour créer et initialiser un objet FaxPorts pour le serveur de télécopie connecté.
4. Appelez la méthode IFaxPorts::get_Count , puis la méthode IFaxPorts::get_Item pour récupérer les pointeurs d’interface IDispatch pour chaque objet FaxPort enfant. (Vous pouvez également appeler la méthode IUnknown::QueryInterface pour récupérer un pointeur d’interface IFaxPort .)
5. Utilisez le pointeur d’interface IDispatch pour appeler la méthode d’interface IFaxPort::GetRoutingMethods , afin de récupérer un pointeur d’interface IDispatch vers un objet FaxRoutingMethods .
6. Appelez la méthode IFaxRoutingMethods::get_Count , puis la méthode IFaxRoutingMethods::get_Item pour récupérer les pointeurs d’interface IDispatch pour chaque objet FaxRoutingMethod enfant.
7. Utilisez le pointeur d’interface IDispatch pour appeler les méthodes d’interface IFaxRoutingMethod .
8. Appelez la méthode IFaxServer::D isconnect pour vous déconnecter du serveur de télécopie.
9. Appelez la méthode IUnknown::Release pour chaque objet FaxRoutingMethod afin de permettre à l’objet de se libérer. Appelez également IUnknown::Release pour chaque objet FaxPort et pour détruire le pointeur d’interface IFaxPorts .

Spécifications

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	faxcom.h

Voir aussi

Interfaces de l’API cliente du service de télécopie

API cliente du service de télécopie pour Windows 2000

IDispatch