Metodo IWMPMediaCollection2::getStringCollectionByQuery

Articolo
06/21/2023

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché 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 getStringCollectionByQuery metodo restituisce un'interfaccia IWMPStringCollection che fornisce l'accesso al set di tutti i valori di stringa per un attributo specificato che corrisponde alle condizioni di query.

Sintassi

public IWMPStringCollection getStringCollectionByQuery(
  System.String bstrAttribute,
  IWMPQuery pQuery,
  System.String bstrMediaType,
  System.String bstrSortAttribute,
  System.Boolean fSortAscending
);


Public Function getStringCollectionByQuery( _
  ByVal bstrAttribute As System.String, _
  ByVal pQuery As IWMPQuery, _
  ByVal bstrMediaType As System.String, _
  ByVal bstrSortAttribute As System.String, _
  ByVal fSortAscending As System.Boolean _
) As IWMPStringCollection
Implements IWMPMediaCollection2.getStringCollectionByQuery

Parametri

bstrAttribute [in]: Nome dell'attributo System.String .
pQuery [in]: Interfaccia WMPLib.IWMPQuery che definisce le condizioni usate per recuperare la raccolta di stringhe.
bstrMediaType [in]: System.String è il tipo di supporto. Deve contenere uno dei valori seguenti: "audio", "video", "foto", "playlist" o "altro".
bstrSortAttribute [in]: System.String che corrisponde al nome dell'attributo usato per l'ordinamento. Una stringa di lunghezza zero ("") significa che non viene applicato alcun ordinamento.
fSortAscending [in]: Valore System.Boolean che indica se il set di valori stringa deve essere ordinato in ordine crescente.

Valore restituito

Interfaccia WMPLib.IWMPStringCollection per il set recuperato di valori stringa.

Commenti

Le query composte che usano IWMPQuery non sono distinzione tra maiuscole e minuscole.

Quando la query composta specificata dal parametro pQuery contiene una condizione basata sull'attributo MediaType , tale condizione viene ignorata. Il valore per il parametro bstrMediaType viene sempre usato. Ad esempio, se la query composta contiene la condizione "MediaType Equals audio" e il valore per il parametro bstrMediaType è "video", la playlist risultante conterrà solo elementi video.

Requisiti

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

Vedi anche

Interfaccia IWMPMediaCollection2 (VB e C#)
Interfaccia IWMPQuery (VB e C#)
Interfaccia IWMPStringCollection (VB e C#)
Attributo MediaType

Share via