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.
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 the CD info will be available, the CallbackForRecordersEvents delegate is invoked with the nEvent parameter set to EV_REC_CDDB_ALBUM_INFO_AVAIL and at this point it will be possible:
This method call will also try to obtain the CD cover pictures: in case it should find them, the CallbackForRecordersEvents delegate is invoked with the nEvent parameter set to
| • | EV_REC_CD_COVER_URLS_AVAIL: notifies that the URL pointing to a certain CD cover picture is available and can be obtained through a call to the GetCdCoverPictureURL method. |
| • | EV_REC_D_COVER_SMALL_FILE_AVAIL, EV_REC_CD_COVER_MEDIUM_FILE_AVAIL and EV_REC_CD_COVER_LARGE_FILE_AVAIL: notify that a certain CD cover picture has been downloaded and is now available locally: the local absolute pathname of the picture can at this point be obtained through a call to the GetCdCoverPictureFile method. It's important to note that the downloaded picture files are temporarily stored inside the system defined "Temp" directory and are automatically deleted when the container application is closed. |
See the How to get pictures of CD covers tutorial for further details.
Syntax
[Visual Basic]
Public Function CdRequestAlbumInfo (
strArtist as string,
strAlbum as string,
strReserved as string
) as enumErrorCodes
|
|
[C#]
public enumErrorCodes CdRequestAlbumInfo (
string strArtist,
string strAlbum,
string strReserved
);
|
|
[C++]
public: enumErrorCodes CdRequestAlbumInfo (
string strArtist,
string strAlbum,
string strReserved
);
|
|
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.
|
strReserved
|
String reserved for future uses
|
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.
|
|
