CdRequestAlbumInfo method

CdRequestAlbumInfo method

Remarks

Given the name of an artist and the title of an album, tries to obtain titles of contained tracks and the related CD cover pictures from the Amazon catalogue.

This method obtains exactly the same information returned by the CddbRequestAlbumInfo method but it doesn't need the CD to be physically available inside the CD drive.

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.

As already mentioned, this method call will also try to obtain the CD cover pictures available on the Amazon web site: 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 from the Amazon Web Service using the GetCdCoverPictureURL method

Getting the temporary file pathname, containing the CD cover pictures downloaded from the Amazon web site, using the GetCdCoverPictureFile method.

See the How to get a CD cover picture tutorial for further details.

Syntax

[Visual Basic]

control.CdRequestAlbumInfo (

strArtist as String,

strAlbum as String,

strAmazonDeveloperCode as String

) as enumErrorCodes

[C++]

short control.CdRequestAlbumInfo (

LPCTSTR strArtist,

LPCTSTR strAlbum,

LPCTSTR strAmazonDeveloperCode

);

Parameter	Description

strArtist	String representing the artist name: if it shouldn't be complete the search session would try finding the best match.
strAlbum	String representing the album title: if it shouldn't be complete the search session would try finding the best match.
strAmazonDeveloperCode	String representing the Amazon developer code: this string is optional but it's strongly recommended that you obtain a developer code from Amazon; visit the Amazon Web Services site for creating your own account

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.