3.2.4.4.1.49 IVolumeClient::GetDontShow (Opnum 58)

  • Article

The GetDontShow method retrieves a Boolean value that indicates whether to show a disk initialization tool.<175>

 HRESULT GetDontShow(
   [out] boolean* bGetNoShow
 );

bGetNoShow: Boolean value that indicates whether the New Disk Wizard is enabled or disabled.

Value

Meaning

FALSE

0

New Disk Wizard is enabled. This value is the default. It indicates that the user has not selected the check box in the New Disk Wizard to request that the wizard not be displayed in the future.

TRUE

1

New Disk Wizard is disabled. This value indicates that the user has selected the check box in the New Disk Wizard to request that the wizard not be displayed in the future.

Return Values: The method MUST return 0 or a nonerror HRESULT on success, or an implementation-specific nonzero error code on failure (as specified in [MS-ERREF]; see also section 2.2.1 for HRESULT values predefined by the Disk Management Remote Protocol).

Upon receiving this message, the server MUST validate parameters:

  1. Verify that bGetNoShow is not NULL.

If parameter validation fails, the server MUST fail the operation immediately, returning an appropriate error as its response to the client.

Otherwise, the server MUST compose a response to the client as follows:

  1. Retrieve the bGetNoShow setting saved on persistent storage (registry) during the most recent call to IVolumeClient::SetDontShow.

  2. The setting MUST be returned to the client in the output parameter bGetNoShow.

  3. Return a response that contains the output parameters mentioned previously and the status of the operation.