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

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

  • Статья

Метод SetReferences задает ссылки, содержащиеся в хранилище со ссылками (например, список воспроизведения или альбом), перезаписав все ранее существующие ссылки, содержащиеся в этом хранилище.

Синтаксис

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IMDSPStorage **ppISPStorage
);

Параметры

[in] dwRefs

Количество указателей интерфейса IMDSPStorage , содержащихся в переданном массиве. Ноль является допустимым значением и сбрасывает хранилище, чтобы содержать нулевые ссылки. Само хранилище в этом случае не удаляется.

[in] ppISPStorage

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

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

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

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

Комментарии

Любой допустимый объект IMDSPStorage может содержаться в массиве ppIMDSPStorage . Сюда входят папки и другие хранилища, содержащие сами ссылки (например, создание списка воспроизведения списков воспроизведения).

В зависимости от уровня поддержки на устройстве (поддерживает ли оно списки воспроизведения или вложенные списки воспроизведения), поставщик услуг должен обрабатывать этот метод соответствующим образом. Если у устройства нет поддерживаемого уровня, необходимого для переданного ссылочного массива, поставщик услуг должен вернуть WMDM_E_NOTSUPPORTED.

Если ссылка содержит удаленное хранилище, необходимо вернуть WMDM_E_INTERFACEDEAD.

Метод SetReferences следует модели очистки и загрузки. Переданные ссылки включают полный набор и должны полностью заменить все существующие ссылки на объект хранилища.

Требования

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

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

Интерфейс IMDSPStorage4

IMDSPStorage4::GetReferences