Metodo IWMDMStorage4::FindStorage (mswmdm.h)

Articolo
03/05/2024

Il metodo FindStorage recupera un archivio nell'archiviazione radice corrente, in base al relativo identificatore univoco persistente.

Sintassi

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

Parametri

[in] findScope

Enumerazione WMDM_FIND_SCOPE che specifica l'ambito da cercare.

[in] pwszUniqueID

Identificatore univoco persistente dell'archiviazione da trovare. L'identificatore univoco persistente dell'archiviazione è descritto dalla proprietà dei metadati g_wszWMDMPersistentUniqueID dell'archiviazione.

[out] ppStorage

Puntatore all'archiviazione recuperata, se trovato. Il chiamante deve rilasciare questa interfaccia al momento dell'operazione.

Valore restituito

Il metodo restituisce un HRESULT. Tutti i metodi di interfaccia in Windows Media Gestione dispositivi possono restituire una delle classi di codici di errore seguenti:

Codici di errore COM standard
Codici di errore di Windows convertiti in valori HRESULT
Codici di errore di Windows Media Gestione dispositivi

Per un elenco completo dei codici di errore possibili, vedere Codici di errore.

Commenti

Questo metodo cerca solo un singolo oggetto memoria (scheda flash o disco rigido) nel dispositivo.

Un identificatore univoco permanente identifica il contenuto archiviato in un determinato dispositivo. Non rappresenta un identificatore univoco globale specifico del contenuto che rimane identico in tutti i dispositivi. Pertanto, lo stesso contenuto archiviato in archiviazioni diverse avrà identificatori univoci permanenti diversi. Analogamente, il contenuto diverso può avere lo stesso identificatore univoco persistente quando archiviato in dispositivi diversi.

Il formato dell'identificatore univoco persistente dipende dal dispositivo. L'applicazione deve avere ottenuto l'identificatore univoco persistente in precedenza ottenendo un archivio e eseguendone una query per la relativa proprietà WMDM/PersistentUniqueID . Usare i metodi GetSpecifiedMetadata o GetMetadata per richiedere questa proprietà.