Copyright © 2005-2018 MultiMedia Soft

CdRequestAlbumInfo method

Previous pageReturn to chapter overviewNext page

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 is available the container application is notified through the CallbackForCdDrivesEvents delegate which is invoked with the nEvent parameter set to EV_CDDB_ALBUM_INFO_AVAIL: 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 container application is notified through the CallbackForCdDrivesEvents delegate which is invoked with the nEvent parameter set to:

 

EV_CD_COVER_URLS_AVAIL so it will be possible getting the URLs of the CD cover pictures from the Amazon Web Service using the GetCdCoverPictureURL method.
EV_CD_COVER_SMALL_FILE_AVAIL, EV_CD_COVER_MEDIUM_FILE_AVAIL and EV_CD_COVER_LARGE_FILE_AVAIL so it will be possible 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]

Public Function CdRequestAlbumInfo (

strArtist as string,

strAlbum as string,

strAmazonDeveloperCode as string

) as enumErrorCodes


 

[C#]

public enumErrorCodes CdRequestAlbumInfo (

string strArtist,

string strAlbum,

string strAmazonDeveloperCode

);


 

[C++]

public: enumErrorCodes CdRequestAlbumInfo (

string strArtist,

string strAlbum,

string 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.

 

IMPORTANT TOPIC: starting from May 2009 the developer code is no more enough in order to access Amazon web services; from that date the access must be performed through a combination of the existing developer code and of a new secret key which is provided by Amazon itself to each registered developer. The new secret key can be requested through the Amazon control panel by accessing your Amazon account. Once you have obtained the new secret key, you can use this parameter in order to pass both the developer code and the secret key using the following syntax:

 

"DeveloperCode-----SecretKey"

 

where the existing developer code and the secret key are separated by 5 '-' (minus) characters.

 

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred. Check the LastError property value in order to see the last error.

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.