IDiscFormat2Data::put_PostgapAlreadyInImage method (imapi2.h)

Article
02/22/2024

Determines if the data stream contains post-writing gaps.

Syntax

HRESULT put_PostgapAlreadyInImage(
  [in] VARIANT_BOOL value
);

Parameters

[in] value

Set to VARIANT_TRUE if the data stream contains post-writing gaps; 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_DF2DATA_WRITE_IN_PROGRESS	There is currently a write operation in progress. Value: 0xC0AA0400

Remarks

Note that writing to CD-R/RW media will automatically append a post-gap of 150 sectors, unless this property is explicitly disabled.

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