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

Artigo
03/13/2024

O método FindStorage localiza um armazenamento por seu identificador exclusivo persistente. Ao contrário de outros métodos, esse método pode pesquisar recursivamente no armazenamento raiz.

Sintaxe

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

Parâmetros

[in] findScope

Uma enumeração WMDM_FIND_SCOPE especificando o escopo da operação de localização.

[in] pwszUniqueID

Um caractere largo, cadeia de caracteres terminada em nulo que representa um identificador exclusivo persistente do armazenamento, que pode ser recuperado consultando a propriedade g_wszWMDMPersistentUniqueID do armazenamento.

[out] ppStorage

Ponteiro para o armazenamento retornado. O chamador deve liberar essa interface quando terminar com ela.

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

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. Da mesma forma, conteúdo diferente pode ter o mesmo identificador exclusivo persistente quando armazenado em dispositivos diferentes. Usando a analogia do conteúdo em um dispositivo que é semelhante a linhas em um banco de dados, essa propriedade tem a mesma finalidade que a coluna de identidade serve em um banco de dados.

Como ele é gerado pelo dispositivo, o formato do identificador exclusivo persistente depende do dispositivo. O aplicativo deve obter o identificador exclusivo persistente consultando a propriedade g_wszWMDMPersistentUniqueID do armazenamento. Um aplicativo pode usar os métodos GetSpecifiedMetadata ou GetMetadata para consultar essa propriedade.