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

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

  • Статья

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

Синтаксис

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IWMDMStorage **ppIWMDMStorage
);

Параметры

[in] dwRefs

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

[in] ppIWMDMStorage

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

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

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

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

Комментарии

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

Любой допустимый объект IWMDMStorage может содержаться в массиве ppIWMDMStorage . Сюда входят папки и другие хранилища, указывающие сами ссылки (например, создание списка воспроизведения). Само устройство определяет, как обрабатывается любой конкретный случай объекта-референта. Windows Media диспетчер устройств не применяет какие-либо правила, выходящие за пределы допустимости IWMDMStorage. Рассмотрим случай со списком воспроизведения, содержащим ссылки на вложенные списки воспроизведения. На одном устройстве это запрещено, и SetReferences завершается сбоем. На другом устройстве это разрешено; Воспроизведение просто просматривает весь набор содержащихся ссылок в порядке глубины.

Может возникнуть ситуация, когда указатель интерфейса IWMDMStorage4 соответствует хранилищу, которое больше не существует на устройстве. в этом случае возвращается WMDM_E_INTERFACEDEAD.

Требования

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

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

Создание списка воспроизведения на устройстве

Интерфейс IWMDMStorage4

IWMDMStorage4::GetReferences