Поделиться через

Метод IMDSPStorage4::GetReferences (mswmdm.h)

  • Статья

Метод GetReferences возвращает массив указателей на объекты IMDSPStorage , состоящие из ссылок, содержащихся в хранилище связей, например , представляющий объекты списка воспроизведения или альбома.

Синтаксис

HRESULT GetReferences(
  [out] DWORD        *pdwRefs,
  [out] IMDSPStorage ***pppISPStorage
);

Параметры

[out] pdwRefs

Указатель на количество указателей интерфейса IWMDMStorage , возвращаемых в pppIWMDMStorage.

[out] pppISPStorage

Указатель на указатель на массив указателей интерфейса IWMDMStorage , представляющих ссылки на хранилище. Такие ссылки могут, например, представлять элементы в списке воспроизведения или альбоме. Порядок ссылок соответствует упорядочению в этом массиве. Память для этого массива должна быть выделена поставщиком услуг.

Возвращаемое значение

Метод возвращает HRESULT. Все методы интерфейса в Windows Media диспетчер устройств могут возвращать любой из следующих классов кодов ошибок:

  • Стандартные коды ошибок COM
  • Коды ошибок Windows, преобразованные в значения HRESULT
  • Коды ошибок диспетчер устройств Windows Media
Подробный список возможных кодов ошибок см. в разделе Коды ошибок.

Комментарии

Windows Media диспетчер устройств использует этот метод для получения ссылок в хранилище связей, например в списке воспроизведения или альбоме.

Если хранилище содержит ссылки на один или несколько элементов, удаленных с устройства, поставщик не должен включать эти ссылки в возвращаемые ссылки. Поставщик служб должен указать такое условие, возвращая S_FALSE. Приложение может обновить объект хранилища сопоставлений с помощью известных ссылок, возвращаемых здесь. Поставщик служб также может обновить сами ссылки.

Если количество ссылок равно 0, поставщик услуг должен возвращать массив ссылок с 0 элементами в нем.

Требования

Требование Значение
Целевая платформа Windows
Header mswmdm.h
Библиотека Mssachlp.lib

См. также раздел

Интерфейс IMDSPStorage4

IMDSPStorage4::SetReferences