FaxEnableRoutingMethodA-Funktion (winfax.h)
Die FaxEnableRoutingMethod-Funktion aktiviert oder deaktiviert eine Faxroutingmethode für ein bestimmtes Faxgerät. Eine Faxverwaltungsanwendung ruft diese Funktion in der Regel für die Geräteverwaltung auf.
Syntax
WINFAXAPI BOOL FaxEnableRoutingMethodA(
[in] HANDLE FaxPortHandle,
[in] LPCSTR RoutingGuid,
[in] BOOL Enabled
);
Parameter
[in] FaxPortHandle
Typ: HANDLE
Gibt ein Faxporthandle an, das von einem Aufruf der FaxOpenPort-Funktion zurückgegeben wird.
[in] RoutingGuid
Typ: LPCTSTR
Zeiger auf eine konstante NULL-endende Zeichenfolge, die die GUID angibt, die die interessante Faxroutingmethode eindeutig identifiziert.
Informationen zu Faxroutingmethoden finden Sie unter Informationen zur Faxroutingerweiterungs-API. Informationen zur Beziehung zwischen Routingmethoden und GUIDs finden Sie unter Faxroutingmethoden.
[in] Enabled
Typ: BOOL
Gibt eine boolesche Variable an, die angibt, ob die Anwendung die durch den RoutingGuid-Parameter angegebene Faxroutingmethode aktiviert oder deaktiviert. Wenn dieser Parameter TRUE ist, aktiviert die Anwendung die Routingmethode. Wenn dieser Parameter FALSE ist, deaktiviert die Anwendung die Routingmethode.
Rückgabewert
Typ: BOOL
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. GetLastError kann einen der folgenden Fehler zurückgeben.
Rückgabecode | Beschreibung |
---|---|
|
Einer oder beide der Parameter FaxPortHandle oder RoutingGuid sind NULL. |
|
Der RoutingGuid-Parameter ist ungültig. |
|
Der Zugriff wird verweigert. FAX_PORT_SET Zugriff ist erforderlich. |
Hinweise
Eine Faxclientanwendung kann die FaxEnableRoutingMethod-Funktion aufrufen, um eine Faxroutingmethode für ein bestimmtes Faxgerät zu aktivieren. Sie kann auch die -Funktion aufrufen, um eine Routingmethode zu deaktivieren, die durch einen vorherigen Aufruf von FaxEnableRoutingMethod oder durch die Verwaltungsanwendung des Faxdiensts aktiviert wurde. Weitere Informationen finden Sie unter Verwalten von Faxroutingdaten.
Rufen Sie die FaxOpenPort-Funktion auf, um ein gültiges Porthandle abzurufen, das im FaxPortHandle-Parameter angegeben werden soll.
Hinweis
Der winfax.h-Header definiert FaxEnableRoutingMethod als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | winfax.h |
Bibliothek | WinFax.lib |
Weitere Informationen
Api-Funktionen des Faxdienstclients
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für