Compartilhar via

Método IMDSPStorage4::SetReferences (mswmdm.h)

  • Artigo

O método SetReferences define as referências contidas em um armazenamento que tem referências (como playlist/álbum), substituindo quaisquer referências existentes anteriormente contidas neste armazenamento.

Sintaxe

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

Parâmetros

[in] dwRefs

Contagem de ponteiros de interface IMDSPStorage contidos na matriz passada. Zero é um valor aceitável e redefine o armazenamento para conter zero referências. O armazenamento em si não é excluído nesse caso.

[in] ppISPStorage

Ponteiro para uma matriz de ponteiros de interface IMDSPStorage usados para definir referências em um armazenamento. A ordenação de referências corresponde à ordenação dos ponteiros de interface IWMDMStorage correspondentes nesta matriz. NULL será um valor aceitável se dwRefs também for zero.

Retornar valor

O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:

  • Códigos de erro COM padrão
  • Códigos de erro do Windows convertidos em valores HRESULT
  • Códigos de erro de Gerenciador de Dispositivos do Windows Media
Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Qualquer objeto IMDSPStorage válido pode estar contido na matriz ppIMDSPStorage . Isso inclui pastas e outros armazenamentos que contêm referências por conta própria (criando, por exemplo, uma playlist de playlists).

Dependendo do nível de suporte no dispositivo (seja ele compatível com playlists ou playlists aninhadas), o provedor de serviços deve lidar com esse método adequadamente. Se o dispositivo não tiver o nível de suporte necessário para a matriz de referência passada, o provedor de serviços deverá retornar WMDM_E_NOTSUPPORTED.

Se a referência contiver um armazenamento excluído, WMDM_E_INTERFACEDEAD deverá ser retornado.

O método SetReferences segue um modelo de apagamento e carregamento. As referências passadas incluem um conjunto completo e devem substituir todas as referências existentes no objeto de armazenamento completamente.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

IMDSPStorage4 Interface

IMDSPStorage4::GetReferences