Método Media.getItemInfoByType

[O recurso associado a esta página, Reprodutor Multimídia do Windows SDK, é um recurso herdado. Foi substituído pelo MediaPlayer. O MediaPlayer foi otimizado para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use o MediaPlayer em vez de Reprodutor Multimídia do Windows SDK, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

O método getItemInfoByType recupera o valor do atributo correspondente ao nome do atributo, ao idioma e ao índice especificados.

Sintaxe

retVal = Media.getItemInfoByType(
  name,
  language,
  index
)

Parâmetros

name [in]

Cadeia de caracteres que contém o nome do atributo. Para obter informações sobre os atributos compatíveis com Reprodutor Multimídia do Windows, consulte a Referência de atributo Reprodutor Multimídia do Windows.

idioma [in]

Cadeia de caracteres que representa o idioma. Se o valor for definido como nulo ou "" (cadeia de caracteres vazia), a cadeia de caracteres de localidade atual será usada. Caso contrário, o valor deve ser uma cadeia de caracteres de idioma RFC 1766 válida, como "en-us".

index [in]

Número (long) que contém o índice baseado em zero do valor a ser recuperado do atributo.

Retornar valor

Esse método retorna um objeto Number, String, MetadataPicture ou MetadataText , conforme indicado na tabela a seguir.

Atributo	Retornar valor
SyncState	Número (longo sem sinal)
WM/Lyrics_Synchronised	Objeto MetadataText
WM/Imagem	Objeto MetadataPicture
WM/UserWebURL	Objeto MetadataText
Todos os outros atributos	Cadeia de caracteres

Para atributos cujo valor subjacente é booliano, esse método retorna a cadeia de caracteres "true" ou "false".

Comentários

Esse método recupera os metadados de um item de mídia digital individual ou um item de mídia que faz parte de uma playlist.

Esse método dá suporte a atributos com vários valores e atributos com valores complexos. O método getItemInfo não dá suporte a atributos com vários valores e atributos com valores complexos.

A propriedade attributeCount contém o número de nomes de atributo disponíveis para um determinado objeto Media . Os números de índice podem ser usados com o método getAttributeName para determinar o nome de cada atributo disponível. Nomes de atributo individuais podem ser passados para o parâmetro name de getItemInfoByType.

O método getAttributeCountByType retorna o número de atributos que correspondem a um nome de atributo específico para um determinado objeto Media . Os números de índice podem ser passados para o parâmetro de índicegetItemInfoByType. Isso é útil quando um item de mídia digital é categorizado em vários gêneros, por exemplo.

Para usar esse método, o acesso de leitura à biblioteca é necessário. Para obter mais informações, consulte Acesso à biblioteca.

Esse método pode causar erros. Você deve incluir o código de tratamento de erros ao chamar esse método. Por exemplo, no JScript, você pode implementar o tratamento de erros usando a tentativa... Pegar... estrutura finally .

Reprodutor Multimídia do Windows 10 Mobile: não há suporte para esse método.

Requisitos

Requisito	Valor
Versão	Reprodutor Multimídia do Windows série 9 ou posterior.
DLL	Wmp.dll

Confira também

Objeto Media

Media.attributeCount

Media.getAttributeCountByType

Media.getAttributeName

Media.getItemInfo

Media.setItemInfo

Objeto MetadataPicture

Objeto MetadataText

Lendo valores de atributo

Settings.mediaAccessRights

Settings.requestMediaAccessRights