Managing Global Configuration Data

You must establish a connection with the fax server before you can retrieve or change configuration information for a fax server. The information includes settings for retransmission, branding, archiving, and cover pages; discount rate periods; and the status of the fax server queue.

In the Win32 Environment

The FaxGetConfiguration function permits a fax client application to query the global configuration settings for a fax server. The function returns the information in a FAX_CONFIGURATION structure.

Because the FaxGetConfiguration function allocates the memory required for the FAX_CONFIGURATION structure, the application must call the FaxFreeBuffer function to deallocate the resources.

To modify a fax server's global configuration settings, an application can call the FaxSetConfiguration function.

Note that an application must first call the FaxConnectFaxServer function to obtain a fax server handle before calling the FaxGetConfiguration function and the FaxSetConfiguration function.

In the COM Implementation Environment

You must establish a connection with an active fax server before you can retrieve or set information about FaxServer objects. For more information, see Connecting to a Fax Server.

If you are writing a C/C++ application, you can use the property methods of the IFaxServer interface to retrieve and set global information about FaxServer objects. For a list of properties and methods, see IFaxServer.

If you are writing a Microsoft Visual Basic application, you can retrieve and set the properties of FaxServer objects. See FaxServer for a list of properties and methods of the object.