Metodo IWMDMDevice3::FindStorage (mswmdm.h)

Articolo
03/05/2024

Il metodo FindStorage trova un archivio in base al relativo identificatore univoco permanente. A differenza di altri metodi, questo metodo può cercare in modo ricorsivo dall'archiviazione radice.

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 dell'operazione di ricerca.

[in] pwszUniqueID

Un carattere wide, stringa con terminazione null che rappresenta un identificatore univoco persistente dell'archiviazione, che può essere recuperato eseguendo una query per la proprietà g_wszWMDMPersistentUniqueID dell'archiviazione.

[out] ppStorage

Puntatore all'archiviazione restituita. 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

Un identificatore univoco persistente viene usato per identificare in modo univoco 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 viene archiviato in dispositivi diversi. Usando l'analogia del contenuto in un dispositivo simile alle righe in un database, questa proprietà serve allo stesso scopo della colonna identity serve in un database.

Poiché viene generato dal dispositivo, il formato dell'identificatore univoco permanente dipende dal dispositivo. L'applicazione deve ottenere l'identificatore univoco persistente eseguendo una query sulla proprietà g_wszWMDMPersistentUniqueID dell'archiviazione. Un'applicazione può usare i metodi GetSpecifiedMetadata o GetMetadata per eseguire query su questa proprietà.