3.1.4.2.3 FaxObs_GetVersion (Opnum 1)

  • Article

The client calls the FaxObs_GetVersion (Opnum 1) method to obtain the version number of the server.

In response the server MUST return its version number.

 error_status_t FaxObs_GetVersion(
   [in] handle_t hBinding,
   [out] LPDWORD Version
 );

hBinding: The RPC binding handle for this call. The client SHOULD reuse the RPC binding handle used as an input hBinding argument for the FaxObs_ConnectionRefCount (section 3.1.4.2.2) method call used to connect to the fax server.

Version: A pointer to a DWORD ([MS-DTYP] section 2.2.9) value where on return from this call, the server MUST write its version number. The server MUST write to the low-order WORD ([MS-DTYP] section 2.2.61) of this DWORD value the major version number and to the high-order WORD the minor version number. The returned DWORD value format is as follows:


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

Minor version number

Major version number

Return Values: This method MUST return 0x00000000 (ERROR_SUCCESS) for success; otherwise, it MUST return the following error code, 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_INVALID_PARAMETER

0x00000057

The Version parameter is set to a NULL pointer value.<184>

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