IFileSystemImage::put_MultisessionInterfaces method (imapi2fs.h)
Sets the list of multi-session interfaces for the optical media.
Syntax
HRESULT put_MultisessionInterfaces(
[in] SAFEARRAY *newVal
);
Parameters
[in] newVal
List of multi-session interfaces for the optical media. Each element of the list is a VARIANT whose type is VT_DISPATCH. Query the multi-session interface for its IDispatch interface and set the pdispVal member of the variant to the IDispatch interface.
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 |
---|---|
|
Pointer is not valid.
Value: 0x80004003 |
|
IMAPI does not support the multisession type requested.
Value: 0xC0AAB15B |
|
IMAPI does not allow multi-session with the current media type.
Value: 0xC0AAB159 |
|
IMAPI supports none of the multisession type(s) provided on the current media.
Value: 0xC0AAB15C |
|
One of multisession parameters cannot be retrieved or has a wrong value.
Value: 0xC0AAB162 |
|
Internal error occurred: %1!ls!.
Value: 0xC0AAB100 |
|
Cannot seek to block %1!I64d! on source disc. This value is also returned if the optical media is blank.
Value: 0xC0AAB156 |
Remarks
This method validates that the multi-session type is compatible. The method succeeds if either
- The list contains a single derived IMultisession interface with IMultisession::put_InUse set to VARIANT_TRUE and if the multi-session type is supported on the current media and supported by the IFileSystemImage implementation.
- The list contains no derived IMultisession interfaces whose IMultisession::put_InUse property is set to VARIANT_TRUE, but contains at least one derived IMultisession that is supported on current media and supported by the IFileSystemImage implementation.
For an example, see Creating a Multisession Disc.
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 | imapi2fs.h |
See also
IDiscFormat2Data::get_MultisessionInterfaces