3.1.4.1.64 FAX_GetVersion (Opnum 37)

The fax client application calls the FAX_GetVersion (Opnum 37) method to obtain the version of the fax server it is connected to.

In response, the server MUST check whether the client's fax user account has permissions to discover the fax version. On success, the server MUST return its version.

 error_status_t FAX_GetVersion(
   [in] handle_t hFaxHandle,
   [in, out] PFAX_VERSION pVersion
 );

hFaxHandle: The RPC binding handle for this call. The client SHOULD reuse the RPC binding handle used as an input hBinding argument for the FAX_ConnectFaxServer (section 3.1.4.1.10) or FAX_ConnectionRefCount (section 3.1.4.1.11) method call used to connect to the fax server.

pVersion: A pointer to a FAX_VERSION (section 2.2.22) object.

Return Values: This method MUST return 0x00000000 (ERROR_SUCCESS) for success; otherwise, it MUST return the following error codes, one of the fax-specific errors that are defined in section 2.2.52, or one of the other standard errors defined in [MS-ERREF] section 2.2.

Return value/code	Description
ERROR_ACCESS_DENIED 0x00000005	Access is denied. The client's fax user account does not have the ALL_FAX_USER_ACCESS_RIGHTS (section 2.2.83) access rights required for this operation.

Exceptions Thrown: No exceptions are thrown except those that are thrown by the underlying RPC protocol, [MS-RPCE].