IDiscFormat2TrackAtOnce::get_ExpectedTableOfContents method (imapi2.h)

Retrieves the table of content for the audio tracks that were laid on the media within the track-writing session.

Syntax

HRESULT get_ExpectedTableOfContents(
  [out] SAFEARRAY **value
);

Parameters

[out] value

Table of contents for the audio tracks that were laid on the media within the track-writing session. Each element of the list is a VARIANT of type VT_BYREF|VT_UI1. The pbVal member of the variant contains a binary blob. For details of the blob, see the READ TOC command at ftp://ftp.t10.org/t10/drafts/mmc5/mmc5r03.pdf.

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_WRITE_IN_PROGRESS
A write operation is in progress.

Value: 0xC0AA0500

E_IMAPI_DF2TAO_MEDIA_IS_NOT_PREPARED
The media is not prepared (IDiscFormat2TrackAtOnce::PrepareMedia has not been called).

Value: 0xC0AA0502

E_IMAPI_DF2TAO_TABLE_OF_CONTENTS_EMPTY_DISC
The media is blank.

Value: 0xC0AA0505

E_OUTOFMEMORY
Failed to allocate the required memory.

Value: 0x8007000E

Remarks

The property is not accessible outside a track-writing session. Nor is the property accessible if the disc is blank.

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

See also

IDiscFormat2TrackAtOnce

IDiscFormat2TrackAtOnce::PrepareMedia

IDiscFormat2TrackAtOnce::ReleaseMedia