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

Artigo
02/29/2024

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.