4.5 Message Exchanges During Adding an Outbound Routing Rule

Message exchanges when adding an outbound routing rule

Figure 5: Message exchanges when adding an outbound routing rule

A fax client can add an outbound routing rule on the server. To do so, the fax client performs the following steps:

  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_AddOutboundRule (section 3.1.4.1.6) to add an outbound routing rule on the server. The client passes the following parameters:

    • A handle to the fax connection

    • The area code of the outbound routing rule

    • The country/region code of the outbound routing rule

    • The destination device ID of the rule

    • The destination group of the rule

    • A Boolean value that specifies whether the group is used as the destination

  3. The server does an access check to determine whether the client's fax user account has the permissions to add an outbound routing rule. If the access check fails, the server returns ERROR_ACCESS_DENIED. If the client's fax user account has the permissions to add the rule, the server does the modification and returns a zero to indicate success.

  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.