Compartilhar via

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

  • Artigo

O método FindStorage localiza um armazenamento com o identificador exclusivo persistente fornecido. O identificador exclusivo persistente de um armazenamento é descrito pela propriedade g_wszWMDMPersistentUniqueID desse armazenamento.

Sintaxe

HRESULT FindStorage(
  [in]  WMDM_FIND_SCOPE findScope,
  [in]  LPCWSTR         pwszUniqueID,
  [out] IMDSPStorage    **ppStorage
);

Parâmetros

[in] findScope

Escopo da operação de localização. Deve ser um dos valores a seguir.

Valor Descrição
WMDM_FIND_SCOPE_GLOBAL Pesquise o dispositivo inteiro.
WMDM_FIND_SCOPE_IMMEDIATE_CHILDREN Pesquise somente nos filhos imediatos do armazenamento atual.

[in] pwszUniqueID

Identificador exclusivo persistente do armazenamento.

[out] ppStorage

Ponteiro para o armazenamento retornado especificado pelo parâmetro pwszUniqueID .

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 do Windows Media Gerenciador de Dispositivos
Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

Comentários

O provedor de serviços retorna um identificador exclusivo persistente por meio da propriedade g_wszWMDMPersistentUniqueID do armazenamento. Para um armazenamento específico, o identificador exclusivo persistente fornecido pelo provedor de serviços deve ser o mesmo em diferentes sessões de conexão de dispositivo.

O aplicativo pode chamar FindStorage com esse identificador exclusivo persistente em um ponto posterior. Em resposta, o Windows Media Gerenciador de Dispositivos chama esse método no provedor de serviços.

Um identificador exclusivo persistente é usado para identificar exclusivamente o conteúdo armazenado em um dispositivo específico. Ele não representa um identificador global exclusivo específico do conteúdo que permanece idêntico em todos os dispositivos. Portanto, o mesmo conteúdo armazenado em armazenamentos diferentes terá diferentes identificadores exclusivos persistentes.

Esse método permite pesquisar um armazenamento com base no identificador exclusivo persistente, enquanto IMDSPStorage2::GetStorage permite pesquisar um armazenamento com base no nome.

O Windows Media Gerenciador de Dispositivos chama esse método apenas para dispositivos que podem ser sincronizados com Reprodutor Multimídia do Windows. Consulte Habilitando a sincronização com Reprodutor Multimídia do Windows para obter mais informações.

Requisitos

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

Confira também

Habilitando a sincronização com Reprodutor Multimídia do Windows

IMDSPStorage2::GetStorage

IMDSPStorage4 Interface