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

Artigo
02/29/2024

O método FindStorage recupera um armazenamento no armazenamento raiz atual, com base em seu identificador exclusivo persistente.

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 a ser pesquisado.

[in] pwszUniqueID

Identificador exclusivo persistente do armazenamento a ser encontrado. O identificador exclusivo persistente do armazenamento é descrito pela propriedade de metadados g_wszWMDMPersistentUniqueID do armazenamento.

[out] ppStorage

Ponteiro para o armazenamento recuperado, se encontrado. 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 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

Esse método pesquisa apenas um único objeto de memória (flash cartão ou disco rígido) no dispositivo.

Um identificador exclusivo persistente identifica 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. Da mesma forma, conteúdo diferente pode ter o mesmo identificador exclusivo persistente quando armazenado em dispositivos diferentes.

O formato do identificador exclusivo persistente depende do dispositivo. O aplicativo deve ter obtido o identificador exclusivo persistente anteriormente obtendo um armazenamento e consultando-o para sua propriedade WMDM/PersistentUniqueID . Use os métodos GetSpecifiedMetadata ou GetMetadata para solicitar essa propriedade.