Edit

IDiscMaster2::get_IsSupportedEnvironment method (imapi2.h)

  • Article

Retrieves a value that determines if the environment contains one or more optical devices and the execution context has permission to access the devices.

Syntax

HRESULT get_IsSupportedEnvironment(
  VARIANT_BOOL *value
);

Parameters

value

Is VARIANT_TRUE if the environment contains one or more optical devices and the execution context has permission to access the devices; otherwise, VARIANT_FALSE.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Return code Description
E_POINTER
 Pointer is not valid.

Value: 0x80004003

Remarks

This method loops through all the strings in IDiscMaster2 and attempts to use each string to initialize a DiscRecorder2 object. If any of the recorders on the system succeed the initialization, this method returns TRUE.

The environment must contain at least one type-5 optical device.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header imapi2.h

See also

IDiscMaster2