IFaxServer::Connect-Methode (faxcom.h)

2023-08-23

Die Connect-Methode verbindet eine Faxclientanwendung mit dem angegebenen Faxserver. Vor dem Zugriff auf die meisten Schnittstellen, die mit IFax beginnen, muss die Anwendung diese Methode aufrufen, um eine Verbindung mit einem aktiven Faxserver zu initiieren. Für den Zugriff auf eine IFaxTiff-Schnittstelle ist keine Faxserververbindung erforderlich.

Syntax

HRESULT Connect(
  [in] BSTR ServerName
);

Parameter

[in] ServerName

Typ: BSTR

Gibt eine NULL-endende Zeichenfolge an, die den Namen des Ziel-Faxservers enthält. Wenn dieser Parameter NULL ist, verbindet die -Methode die Anwendung mit dem Faxserver auf dem lokalen Computer. Einschränkungen beim Herstellen einer Verbindung mit Remoteservern finden Sie unter Herstellen einer Verbindung mit einem Faxserver .

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die Faxclientanwendung muss die IFaxServer::D isconnect-Methode aufrufen, um die Verbindung mit dem Faxserver zu trennen.

Weitere Informationen finden Sie unter Herstellen einer Verbindung mit einem Faxserver und Trennen von einem Faxserver.

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	faxcom.h
DLL	Faxcom.dll