PFAXCLOSE-Rückruffunktion (winfax.h)

Die FaxClose-Funktion schließt die folgenden Arten von Faxhandles:

• Ein Faxserverhandle, das von einem Aufruf der FaxConnectFaxServer-Funktion zurückgegeben wird
• Ein Faxporthandle, das von einem Aufruf der FaxOpenPort-Funktion zurückgegeben wird

Syntax

PFAXCLOSE Pfaxclose;

BOOL Pfaxclose(
  [in] HANDLE FaxHandle
)
{...}

Parameter

[in] FaxHandle

Typ: HANDLE

Gibt das zu schließende Faxhandle an. Dieser Wert kann ein Faxserverhandle sein, das von einem Aufruf der FaxConnectFaxServer-Funktion zurückgegeben wird, oder ein Faxporthandle, das von einem Aufruf der FaxOpenPort-Funktion zurückgegeben wird.

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
ERROR_ACCESS_DENIED	Zugriff verweigert.“ FAX_PORT_QUERY Zugriff ist erforderlich.
ERROR_INVALID_HANDLE	Der FaxHandle-Parameter ist ungültig.

Hinweise

Eine Faxclientanwendung muss die FaxClose-Funktion als letzte Funktion aufrufen, bevor sie beendet wird. Die CloseHandle-Funktion kann das Handle nicht an einen Faxserver oder einen Faxport schließen.

Wenn die FaxClose-Funktion ein Von der FaxConnectFaxServer-Funktion zugewiesenes Handle schließt, trennt die Funktion die aufrufende Anwendung vom angegebenen Faxserver.

Eine Faxclientanwendung empfängt weiterhin Faxereignisse vom Faxdienst, nachdem die Anwendung erfolgreich die FaxClose-Funktion aufgerufen hat, um ein Faxserverhandle zu schließen. Dadurch kann der Faxdienst herunterfahren und Systemressourcen schonen, wenn sich der Dienst für einen längeren Zeitraum im Leerlauf befindet. Wenn Sie das Handle für den Faxserver geöffnet lassen, wird der Faxdienst nicht heruntergefahren.

Weitere Informationen finden Sie unter Aktivieren einer Anwendung zum Empfangen von Benachrichtigungen über Faxereignisse, Herstellen einer Verbindung mit einem Faxserver und Trennen von einem Faxserver und FaxInitializeEventQueue.

Anforderungen

Anforderung	Wert
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

Weitere Informationen

Funktionen des Faxdienstclients

Faxdienstclient-API für Windows 2000

FaxConnectFaxServer

FaxOpenPort