Share via

3.1.4.1.92 FAX_SetRecipientsLimit (Opnum 83)

  • Article

The FAX_SetRecipientsLimit (Opnum 83) method is called by the client. A fax client application calls FAX_SetRecipientsLimit to set the recipient limit of a single broadcast job. On success, the server MUST set the recipient limit of a single broadcast job.

Protocol version FAX_API_VERSION_0 (0x00000000) and FAX_API_VERSION_1 (0x00010000) fax servers SHOULD NOT implement this call. 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 MUST NOT call this method if the protocol version reported by the server is FAX_API_VERSION_0 (0x00000000) or FAX_API_VERSION_1 (0x00010000). For more information,  see FAX_ConnectFaxServer (section 3.1.4.1.10).

 error_status_t FAX_SetRecipientsLimit(
   [in] handle_t hbinding,
   [in] DWORD dwRecipientsLimit
 );

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.

dwRecipientsLimit: A DWORD ([MS-DTYP] section 2.2.9) that specifies the maximum number of recipients for the fax.

Return Values: This method SHOULD return 0x00000032 (ERROR_NOT_SUPPORTED).

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