4.2 Message Exchanges During Querying Server Configuration

Message exchanges during the querying of server configuration

Figure 2: Message exchanges during the querying of server configuration

A fax client can query the server to obtain its global configuration. The client does this querying to determine the global settings of the fax server. For example, the client can query for the number of retries, retry delays, and dirty days, and also for the branding and discount rate settings that are available as part of the FAX_CONFIGURATION (section 2.2.28) structure.

The client's fax user account needs to have query configuration access to be able to query for the configuration settings on the server.

The client follows these steps to query for the global configuration settings on the fax server:

  1. The client calls FAX_ConnectFaxServer (section 3.1.4.1.10) to establish a connection to the fax server. The parameters supplied to this function are the server name and a fax connection handle object. The server tries to establish the connection and returns false if the call fails or sets the fax connection handle object if successful.

  2. The client calls FAX_GetConfiguration (section 3.1.4.1.36) to query the fax server configuration.

  3. The server does an access check to determine whether the client's fax user account has the permissions to query configuration. If the access check fails, the server returns ERROR_ACCESS_DENIED. If the client's fax user account has the permissions to query for the server configuration and the call is successful, the server returns the FAX_CONFIGURATION.

  4. To end the connection to the fax server, the client calls FAX_ConnectionRefCount (section 3.1.4.1.11) by using the faxHandle parameter that was obtained in step 1 and a value of 0 for the dwConnect argument.