3.1.4.1.62 FAX_GetServerSKU (Opnum 85)

The FAX_GetServerSKU (Opnum 85) method is called by the client. In response, the server returns the SKU of the fax server operating system.

The server MUST check whether the client's fax user account has permissions to know the server SKU type. On success, the server MUST return its SKU type.

Protocol version FAX_API_VERSION_0 (0x00000000) and FAX_API_VERSION_1 (0x00010000) fax servers SHOULD NOT implement this call. 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_GetServerSKU(
   [in] handle_t hbinding,
   [out, ref] PRODUCT_SKU_TYPE* pServerSKU
 );

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.

pServerSKU: A pointer to a PRODUCT_SKU_TYPE (section 2.2.75) enumeration that receives the fax server SKU.

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_ACCESS_DENIED 0x00000005	Access is denied. The client's fax user account does not have any of the permissions covered by ALL_FAX_USER_ACCESS_RIGHTS (section 2.2.83).

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