3.1.4.1.7 FAX_CheckServerProtSeq (Opnum 26)

  • Article

The FAX_CheckServerProtSeq (Opnum 26) method is called by the client to validate whether a specified protocol sequence is supported by the server.<70> In response, the server MUST validate the specified protocol sequence.

Protocol version FAX_API_VERSION_2 (0x00020000) and FAX_API_VERSION_3 (0x00030000) fax servers SHOULD fail this call by returning ERROR_NOT_SUPPORTED (0x00000032). The fax client SHOULD NOT call this method if the protocol version reported by the server is FAX_API_VERSION_2 (0x00020000) or FAX_API_VERSION_3 (0x00030000). For more information, see FAX_ConnectFaxServer (section 3.1.4.1.10).

 error_status_t FAX_CheckServerProtSeq(
   [in] handle_t hbinding,
   [in, out, unique] LPDWORD lpdwProtSeq
 );

hbinding: 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 or FAX_ConnectionRefCount (section 3.1.4.1.11) method call used to connect to the fax server.

lpdwProtSeq: A variable into which the requested sequence is specified. If the specified protocol sequence is supported, upon return, lpdwProtSeq contains the value for this validated sequence.

Value/code

Meaning

RPC_PROT_TCP_IP

1

Check the protocol sequence for TCP/IP.

RPC_PROT_SPX

2

Check the protocol sequence for IPX/SPX.

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

0x00000057

The parameter is incorrect. The lpdwProtSeq argument specified is NULL.

RPC_S_PROTSEQ_NOT_SUPPORTED

0x0000006A7

The protocol sequence specified by the lpdwProtSeq argument is not supported.

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