Метод IWMDMStorage3::SetEnumPreference (mswmdm.h)

Статья
02/29/2024

Метод SetEnumPreference задает предпочтительный режим просмотра для хранилища.

Синтаксис

HRESULT SetEnumPreference(
  [in, out] WMDM_STORAGE_ENUM_MODE *pMode,
  [in]      DWORD                  nViews,
  [in]      WMDMMetadataView       *pViews
);

Параметры

[in, out] pMode

Требуемый режим перечислителя хранилища. Дополнительные сведения о режиме см. в разделе WMDM_STORAGE_ENUM_MODE. Если для параметра pMode задано значение ENUM_MODE_USE_DEVICE_PREF, то при возврате ему присваивается значение ENUM_MODE_RAW или ENUM_MODE_METADATA_VIEWS в зависимости от предпочтений устройства.

[in] nViews

Количество предоставленных определений представлений.

Этот параметр игнорируется, если значение pMode ENUM_MODE_RAW или если значение pMode ENUM_MODE_USE_DEVICE_PREF и устройство не предпочитает представления метаданных.

Если значение pMode равно ENUM_MODE_METADATA_VIEWS или значение pMode ENUM_MODE_USE_DEVICE_PREF и устройство предпочитает представления метаданных, этот параметр по-прежнему может иметь значение 0. В этом случае windows Media диспетчер устройств использует представления метаданных по умолчанию.

Если значение nViews равно 0, ppViews должно иметь значение NULL. Если значение nViews не равно 0, ppViews должен указывать на массив структур WMDMMetadataView с элементами nViews .

[in] pViews

Массив определений представлений. Длина массива должна быть равна nViews.

Если значение pMode ENUM_MODE_METADATA_VIEWS или значение pMode ENUM_MODE_USE_DEVICE_PREF и устройство предпочитает представления метаданных, этот параметр по-прежнему может иметь значение NULL. В этом случае диспетчер устройств Windows Media использует представления метаданных по умолчанию.

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

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

Метод возвращает HRESULT. В следующей таблице перечислены все возможные значения.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_OUTOFMEMORY	Недостаточно памяти для выделения элемента.
E_INVALIDARG	Один или несколько параметров являются недопустимыми.
WMDM_E_NOT_CERTIFIED	Вызывающий объект не имеет прав на выполнение этой операции.
WMDM_E_NOTSUPPORTED	Объект не поддерживает этот метод.
E_FAIL	Произошла неизвестная ошибка.

Windows Media диспетчер устройств могут представлять представления метаданных содержимого на устройстве. Он просматривает все содержимое хранилища верхнего уровня (например, внутреннюю память или карта хранилища) и возвращает перечислитель хранилища, который представляет содержимое, упорядоченное по метаданным содержимого. Определение представления метаданных предоставляется через структуру WMDMMetadataView .

Это поведение управляется параметром pMode . Если для параметра pMode задано значение ENUM_MODE_RAW, windows Media диспетчер устройств возвращает перечислитель, который отражает иерархию файловой системы на хранилище устройства. Если для параметра pMode задано значение ENUM_MODE_METADATA_VIEWS, диспетчер устройств Windows Media создает представления метаданных.

Устройства указывают свои предпочтения, задавая параметр устройства UseMetadataViews во время установки устройства. Дополнительные сведения о UseMetadataViews см. в разделе Параметры устройства. Если приложение позволит устройству определить тип возвращаемого перечислителя хранилища, оно должно задать для pMode значение ENUM_MODE_USE_DEVICE_PREF.

После вызова этого метода последующие вызовы IWMDMStorage::EnumStorage будут вести себя в соответствии с предпочтениями перечисления хранилища, заданными этим методом. Этот метод можно вызвать снова, чтобы изменить поведение последующих вызовов IWMDMStorage::EnumStorage .

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