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

Artigo
08/25/2023

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 .

Valor retornado

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

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 (SP).

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

O Windows Media Gerenciador de Dispositivos chama esse método apenas para dispositivos registrados para habilitar a sincronização com Reprodutor Multimídia do Windows. Para obter mais informações, consulte Habilitando a sincronização com Reprodutor Multimídia do Windows.