IDiscFormat2TrackAtOnce::get_NumberOfExistingTracks method (imapi2.h)

Article
02/22/2024

Retrieves the number of existing audio tracks on the media.

Syntax

HRESULT get_NumberOfExistingTracks(
  [out] LONG *value
);

Parameters

[out] value

Number of completed tracks written to disc, not including the track currently being added.

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
E_IMAPI_DF2TAO_MEDIA_IS_NOT_PREPARED	The media is not prepared (IDiscFormat2TrackAtOnce::PrepareMedia has not been called). Value: 0xC0AA0502
E_IMAPI_DF2TAO_WRITE_IN_PROGRESS	A write operation is in progress. Value: 0xC0AA0500

Remarks

The value is zero if:

The media is blank
You call this method outside a writing 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