Metodo IWMPStringCollection2::getItemInfobyType

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo getItemInfoByType restituisce il valore corrispondente all'indice dell'elemento della raccolta di stringhe, al nome, alla lingua e all'indice dell'attributo specificati.

Sintassi

public System.Object getItemInfobyType(
  System.Int32 lCollectionIndex,
  System.String bstrType,
  System.String bstrLanguage,
  System.Int32 lAttributeIndex
);

Public Function getItemInfobyType( _
  ByVal lCollectionIndex As System.Int32, _
  ByVal bstrType As System.String, _
  ByVal bstrLanguage As System.String, _
  ByVal lAttributeIndex As System.Int32 _
) As System.Object
Implements IWMPStringCollection2.getItemInfobyType

Parametri

lCollectionIndex [in]

System.Int32 che rappresenta l'indice in base zero dell'elemento della raccolta di stringhe da cui ottenere l'attributo.

bstrType [in]

System.String che corrisponde al nome dell'attributo.

bstrLanguage [in]

System.String che indica la lingua. Se il valore è impostato su Null o su una stringa di lunghezza zero (""), viene usata la stringa delle impostazioni locali corrente. In caso contrario, il valore deve essere una stringa di lingua RFC 1766 valida, ad esempio "en-us".

lAttributeIndex [in]

Oggetto System.Int32 che rappresenta l'indice in base zero dell'attributo.

Valore restituito

Oggetto System.Object che rappresenta l'elemento della raccolta di stringhe.

Commenti

Questo metodo supporta attributi con più valori e attributi con valori complessi. Il metodo getItemInfo non supporta attributi con più valori o attributi con valori complessi.

Passando il valore "ChildList" nel parametro bstrType , è possibile recuperare una nuova raccolta di stringhe contenente gli elementi figlio di uno degli elementi nella raccolta di stringhe padre. Ad esempio, se la raccolta padre contiene un elenco di AlbumIDs, è possibile utilizzare questo metodo per ottenere una raccolta di stringhe figlio contenente tutte le tracce per uno degli album. Questo approccio è più veloce ed efficiente rispetto alla chiamata del metodo IWMPMediaCollection2.getStringCollectionByQuery due volte; una volta per ottenere una raccolta di AlbumIDs e una seconda volta per ottenere una raccolta di tracce per un particolare AlbumID. Per usare ChildList nel modo appena descritto, la raccolta di stringhe padre deve essere ottenuta da una raccolta multimediale tramite IWMPLibraryServices e non usando la proprietà AxWindowsMediaPlayer.mediaCollection .

Quando si usa ChildList, passare il valore "ChildList" nel parametro bstrType e il valore 0 nel parametro lAttributeIndex . È quindi possibile eseguire il cast dell'oggetto restituito a un'interfaccia IWMPStringCollection2 per accedere all'elenco figlio.

Per usare questo metodo, è necessario disporre dell'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows 11.
Spazio dei nomi	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vedi anche

Attributo AlbumID

Interfaccia IWMPLibraryServices (VB e C#)

IWMPMediaCollection2.getStringCollectionByQuery (VB e C#)

Interfaccia IWMPStringCollection2

IWMPStringCollection2.getItemInfo (VB e C#)