Método IMDSPStorage4::GetReferences (mswmdm.h)
O método GetReferences retorna uma matriz de ponteiros para objetos IMDSPStorage que compõem as referências contidas em um armazenamento de associação, como um que representa objetos de playlist ou álbum.
Sintaxe
HRESULT GetReferences(
[out] DWORD *pdwRefs,
[out] IMDSPStorage ***pppISPStorage
);
Parâmetros
[out] pdwRefs
Ponteiro para a contagem de ponteiros de interface IWMDMStorage sendo retornados em pppIWMDMStorage.
[out] pppISPStorage
Ponteiro para um ponteiro para a matriz de ponteiros de interface IWMDMStorage que representam referências em um armazenamento. Essas referências podem, por exemplo, representar itens em uma playlist ou álbum. A ordenação de referências corresponde à ordenação nesta matriz. A memória dessa matriz deve ser alocada pelo provedor de serviços.
Retornar valor
O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:
- Códigos de erro COM padrão
- Códigos de erro do Windows convertidos em valores HRESULT
- Códigos de erro de Gerenciador de Dispositivos do Windows Media
Comentários
O Windows Media Gerenciador de Dispositivos usa esse método para obter as referências em um armazenamento de associação, como uma playlist ou um álbum.
Se o armazenamento tiver referências a um ou mais itens que foram excluídos do dispositivo, o SP não deverá incluir essas referências nas referências retornadas. O SP deve indicar essa condição retornando S_FALSE. O aplicativo pode optar por atualizar o objeto de armazenamento de associação usando as referências conhecidas retornadas aqui. O SP também pode atualizar as referências em si.
Se a contagem de referências for 0, o provedor de serviços deverá retornar uma matriz de referências com 0 elementos.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | mswmdm.h |
| Biblioteca | Mssachlp.lib |