Metodo IMDSPStorage4::SetReferences (mswmdm.h)
Il metodo SetReferences imposta i riferimenti contenuti in un archivio con riferimenti (ad esempio playlist/album), sovrascrivendo eventuali riferimenti esistenti in precedenza contenuti in questa risorsa di archiviazione.
Sintassi
HRESULT SetReferences(
[in] DWORD dwRefs,
[in] IMDSPStorage **ppISPStorage
);
Parametri
[in] dwRefs
Conteggio dei puntatori dell'interfaccia IMDSPStorage contenuti nella matrice passata. Zero è un valore accettabile e reimposta l'archiviazione per contenere zero riferimenti. L'archiviazione stessa non viene eliminata in questo caso.
[in] ppISPStorage
Puntatore a una matrice di puntatori dell'interfaccia IMDSPStorage usati per impostare i riferimenti in un'archiviazione. L'ordinamento dei riferimenti corrisponde all'ordinamento dei puntatori di interfaccia IWMDMStorage corrispondenti in questa matrice. NULL è un valore accettabile se dwRefs è anche zero.
Valore restituito
Il metodo restituisce un 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
Qualsiasi oggetto IMDSPStorage valido può essere contenuto nella matrice ppIMDSPStorage . Sono incluse cartelle e altre risorse di archiviazione contenenti riferimenti stessi (ad esempio, la creazione di una playlist di playlist).
A seconda del livello di supporto nel dispositivo (se supporta playlist o playlist annidate), il provider di servizi deve gestire questo metodo in modo appropriato. Se il dispositivo non ha il livello di supportato per la matrice di riferimento passata, il provider di servizi deve restituire WMDM_E_NOTSUPPORTED.
Se il riferimento contiene un archivio eliminato, WMDM_E_INTERFACEDEAD deve essere restituito.
Il metodo SetReferences segue un modello di cancellazione e caricamento. I riferimenti passati includono un set completo e devono sostituire tutti i riferimenti esistenti nell'oggetto di archiviazione completamente.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |