3.1.4.1.77 FAX_SetConfigWizardUsed (Opnum 77)

The FAX_SetConfigWizardUsed (Opnum 77) method is called by the client. The server MUST validate that the client's fax user account has access to manage configuration information on the server. On success, the server MUST set a value in the registry indicating whether or not the configuration wizard was used. <159>

 error_status_t FAX_SetConfigWizardUsed(
   [in] handle_t hFaxHandle,
   [in] BOOL bConfigWizardUsed
 );

hFaxHandle: The handle that is provided by the client RPC layer when the RPC call is made.

bConfigWizardUsed: A Boolean value indicating whether the fax configuration wizard was used.

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_ACCESS_DENIED

0x00000005

Access is denied. The caller does not have the required rights (FAX_ACCESS_MANAGE_CONFIG) to perform this operation.

ERROR_REGISTRY_CORRUPT

0x000003F7

The registry is corrupted. The structure of one of the files containing registry data is corrupted, or the system's memory image of the file is corrupted.

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