Метод Media.getAttributeCountByType

Статья
06/21/2023

[Функция, связанная с этой страницей, Медиаплеер Windows SDK, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод getAttributeCountByType извлекает количество атрибутов, связанных с указанным именем атрибута и языком.

Синтаксис

retVal = Media.getAttributeCountByType(
  name,
  language
)

Параметры

name [in]: Строка , содержащая имя атрибута. Сведения об атрибутах, поддерживаемых Медиаплеер Windows, см. в справочнике по атрибутам Медиаплеер Windows.
language [in]: Строка , представляющая язык. Если задано значение NULL или "" (пустая строка), используется текущая строка языкового стандарта. В противном случае значение должно быть допустимой строкой языка RFC 1766, например en-us.

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

Этот метод возвращает число (long), содержащее число атрибутов.

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

Для использования этого метода требуется доступ на чтение к библиотеке. Дополнительные сведения см. в разделе Доступ к библиотеке.

Медиаплеер Windows 10 Mobile: это свойство всегда возвращает значение 0.

Требования

Требование	Значение
Версия	Медиаплеер Windows серии 9 или более поздней версии.
DLL	Wmp.dll

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

MediaObject
Media.getItemInfoByType
Settings.mediaAccessRights
Settings.requestMediaAccessRights