IDiscFormat2Data::put_ForceMediaToBeClosed method (imapi2.h)

Determines if further additions to the file system are prevented.

Syntax

HRESULT put_ForceMediaToBeClosed(
  [in] VARIANT_BOOL value
);

Parameters

[in] value

Set to VARIANT_TRUE to mark the disc as closed to prohibit additional writes when the next write session ends.

Set to VARIANT_FALSE to keep the disc open for subsequent write sessions. The default is 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:

Remarks

When the free space on a disc reaches 2% or less, the write process marks the disc closed, regardless of the value of this property. This action ensures that a disc has enough free space to record a file system in a write session.

You can erase a rewritable disc that is marked closed.

Note that the IDiscFormat2Data::put_DisableConsumerDvdCompatibilityMode property may supersede this property. Please refer to put_DisableConsumerDvdCompatibilityMode for details.

Requirements

See also

IDiscFormat2Data

IDiscFormat2Data::get_ForceMediaToBeClosed