IDiscFormat2TrackAtOnce::put_DoNotFinalizeMedia method (imapi2.h)

Article
02/22/2024

Determines if the media is left open for writing after writing the audio track.

Syntax

HRESULT put_DoNotFinalizeMedia(
  [in] VARIANT_BOOL value
);

Parameters

[in] value

Set to VARIANT_TRUE to leave the media open for writing after writing the audio track; otherwise, VARIANT_FALSE. 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:

Return code	Description
E_IMAPI_DF2TAO_WRITE_IN_PROGRESS	A write operation is in progress. Value: 0xC0AA0500
E_IMAPI_DF2TAO_MEDIA_IS_PREPARED	The requested operation is not valid when media has been "prepared" but not released. Value: 0xC0AA0503
E_IMAPI_DF2TAO_PROPERTY_FOR_BLANK_MEDIA_ONLY	The property cannot be changed once the media has been written to. Value: 0xC0AA0504

Remarks

You can set this property before calling the IDiscFormat2TrackAtOnce::PrepareMedia method or after calling the IDiscFormat2TrackAtOnce::ReleaseMedia method; you cannot set it during a track-writing session.

This property is useful to create a multi-session CD with audio in the first session and data in the second session.

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