Methods > CD drives and ripping > CDDB > CddbRequestAlbumInfo method

Remarks

Requests the CDDB album info for the CD currently inside the given CD drive: this call needs an active Internet connection.

When requested information will become available, a CddbAlbumInfoAvailable event will be raised: at this point it will be possible:

Obtaining the CD album info through the CddbGetAlbumInfo method.

Getting each CD track title through the CddbGetTrackTitle method.

This method call will also try to obtain the CD cover pictures: in case it should find them, the CdCoverURLsAvailable and CdCoverPictureFileAvailable events will be raised so it will be possible:

Getting the URLs of the CD cover pictures using the GetCdCoverPictureURL method

Getting the temporary file pathname, containing the downloaded CD cover pictures, using the GetCdCoverPictureFile method.

See the How to get Audio CD info using CDDB servers tutorial for further details.

Syntax

[Visual Basic]

control.CddbRequestAlbumInfo (

nCdDriveIndex as integer,

nServerIndex as integer,

) as enumErrorCodes

[C++]

short control.CddbRequestAlbumInfo (

short nCdDriveIndex,

short nServerIndex

);

Parameter	Description

nCdDriveIndex	Number representing the zero-based index of the involved CD drive
nServerIndex	Number representing the zero-based index of the CDDB server that will be used in order to obtain the CD album information. The list of available CDDB servers can be obtained through the CddbRequestServersList method.

Return value

Value	Meaning

Negative value	An error occurred, check the LastError property value in order to see the error code meaning
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.