IFaxServer::Connect method (faxcom.h)
The Connect method connects a fax client application to the specified fax server. Before accessing most interfaces that begin with IFax, the application must call this method to initiate a connection with an active fax server. A fax server connection is not required to access an IFaxTiff interface.
Syntax
HRESULT Connect(
[in] BSTR ServerName
);
Parameters
[in] ServerName
Type: BSTR
Specifies a null-terminated string that contains the name of the target fax server. If this parameter is NULL, the method connects the application to the fax server on the local computer. See Connecting to a Fax Server for limitations on connecting to remote servers.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
The fax client application must call the IFaxServer::Disconnect method to disconnect from the fax server.
For more information, see Connecting to a Fax Server and Disconnecting from a Fax Server.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | faxcom.h |
| DLL | Faxcom.dll |
See also
Disconnecting from a Fax Server
Fax Service Client API Interfaces