Metodo IWMDMStorage4::SetReferences (mswmdm.h)
Il metodo SetReferences imposta i riferimenti contenuti in una risorsa di archiviazione con riferimenti ,ad esempio una playlist o un album, sovrascrivendo eventuali riferimenti esistenti in precedenza contenuti nella risorsa di archiviazione.
Sintassi
HRESULT SetReferences(
[in] DWORD dwRefs,
[in] IWMDMStorage **ppIWMDMStorage
);
Parametri
[in] dwRefs
Conteggio dei puntatori all'interfaccia IWMDMStorage in ppIWMDMStorage. Zero è un valore accettabile e cancella tutti i riferimenti dalla risorsa di archiviazione. L'archiviazione stessa non viene eliminata in questo caso.
[in] ppIWMDMStorage
Puntatore a una matrice di puntatori di interfaccia IWMDMStorage a cui fare riferimento l'archiviazione. Questo ordine viene mantenuto dalla risorsa di archiviazione. NULL è un valore accettabile se dwRefs è anche zero. Il chiamante è responsabile dell'allocazione e del rilascio di questa matrice.
Valore restituito
Il metodo restituisce un valore HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:
- Codici di errore COM standard
- Codici di errore di Windows convertiti in valori HRESULT
- Codici di errore di Windows Media Gestione dispositivi
Commenti
Questo metodo viene usato per impostare riferimenti in oggetti composti da riferimenti, ad esempio playlist o album. Se un dispositivo non supporta i metadati, questo metodo probabilmente non sarà supportato.
Qualsiasi oggetto IWMDMStorage valido può essere contenuto nella matrice ppIWMDMStorage . Sono incluse cartelle e altre risorse di archiviazione che specificano i riferimenti stessi (creando, ad esempio, una playlist di playlist). Il dispositivo stesso determina la modalità di gestione di qualsiasi caso specifico dell'oggetto referenziale. Windows Media Gestione dispositivi non applica regole oltre a quella della validità di IWMDMStorage. Si consideri il caso di una playlist contenente riferimenti a playlist nidificate. In un dispositivo non è consentito e SetReferences ha esito negativo. In un altro dispositivo, questo è consentito; la riproduzione attraversa semplicemente l'intero set di riferimenti contenuti in ordine approfondito.
La situazione può verificarsi quando un puntatore all'interfaccia IWMDMStorage4 corrisponde a una risorsa di archiviazione che non esiste più nel dispositivo. WMDM_E_INTERFACEDEAD viene restituito in questo caso.
Requisiti
Requisito | Valore |
---|---|
Piattaforma di destinazione | Windows |
Intestazione | mswmdm.h |
Libreria | Mssachlp.lib |