Copyright © 2011-2018 MultiMedia Soft

TagsEditor.ID3V2_PopularimeterFrameAdd method

Previous pageReturn to chapter overviewNext page

Remarks

 

Adds a new popularimeter frame (POPM) to the ID3V2 tag. If a popularimeter frame having the same E-mail already exists, it will be replaced by the new one: this can be also used to modify the rating and/or the play counter of the previous one.

The modification only happens in memory and not directly into the original sound file: in order to store modifications inside the file you need to call the TagsEditor.ID3V2_SaveChanges method.

 

For further details about methods related to tags editing refer to the TagsEditorMan class.

For details about the editing of tags see the How to edit tag info in sound files tutorial.

 

 

Syntax

 

[Visual Basic]

Public Function ID3V2_PopularimeterFrameAdd (

strEmail as String,

nRating as Int32,

nCounter as Int32

) as enumErrorCodes


 

[C#]

public string ID3V2_PopularimeterFrameAdd (

string strEmail,

Int32 nRating,

Int32 nCounter

);


 

[C++]

public: string ID3V2_PopularimeterFrameAdd (

string strEmail,

Int32 nRating,

Int32 nCounter

);


 

Parameter

Description

 

 

strEmail

String containing the personal e-mail address

nRating

Value determining the song rating: can be a value in the range from 1 (worst) to 255 (best), 0 means that no rating is assigned

nCounter

Value determining the play counter

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred (see the LastError property for further error details)

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.