Metodo IMDSPStorage4::GetReferences (mswmdm.h)
Il metodo GetReferences restituisce una matrice di puntatori agli oggetti IMDSPStorage che comprendono i riferimenti contenuti in un archivio di associazione, ad esempio uno che rappresenta oggetti playlist o album.
Sintassi
HRESULT GetReferences(
[out] DWORD *pdwRefs,
[out] IMDSPStorage ***pppISPStorage
);
Parametri
[out] pdwRefs
Puntatore al conteggio dei puntatori dell'interfaccia IWMDMStorage restituiti in pppIWMDMStorage.
[out] pppISPStorage
Puntatore a un puntatore alla matrice di puntatori dell'interfaccia IWMDMStorage che rappresentano riferimenti in un archivio. Tali riferimenti possono, ad esempio, rappresentare elementi in una playlist o in un album. L'ordinamento dei riferimenti corrisponde all'ordinamento in questa matrice. La memoria per questa matrice deve essere allocata dal provider di servizi.
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
Windows Media Gestione dispositivi usa questo metodo per ottenere i riferimenti in un archivio di associazione, ad esempio una playlist o un album.
Se l'archiviazione ha riferimenti a uno o più elementi eliminati dal dispositivo, il server di gestione risorse non deve includere questi riferimenti nei riferimenti restituiti. Il nome SP deve indicare tale condizione restituendo S_FALSE. L'applicazione potrebbe scegliere di aggiornare l'oggetto di archiviazione dell'associazione usando i riferimenti noti restituiti qui. Il sp può anche aggiornare i riferimenti stessi.
Se il conteggio dei riferimenti è 0, il provider di servizi deve restituire una matrice di riferimenti con 0 elementi.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | mswmdm.h |
| Libreria | Mssachlp.lib |