Metodo IMDSPDevice3::FindStorage (mswmdm.h)

Articolo
03/15/2023

Il metodo FindStorage trova una risorsa di archiviazione con l'identificatore univoco permanente specificato. L'identificatore univoco permanente di una risorsa di archiviazione viene descritto dalla proprietà g_wszWMDMPersistentUniqueID di tale risorsa di archiviazione.

Sintassi

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

Parametri

[in] findScope

Ambito dell'operazione di ricerca. Deve essere uno dei valori seguenti.

Valore	Descrizione
WMDM_FIND_SCOPE_GLOBAL	Cercare l'intero dispositivo.
WMDM_FIND_SCOPE_IMMEDIATE_CHILDREN	Eseguire la ricerca solo negli elementi figlio immediati dello spazio di archiviazione corrente.

[in] pwszUniqueID

Identificatore univoco permanente della risorsa di archiviazione.

[out] ppStorage

Puntatore alla risorsa di archiviazione restituita specificata dal parametro pwszUniqueID .

Valore restituito

Il metodo restituisce un valore 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

Il provider di servizi restituisce un identificatore univoco permanente tramite la proprietà g_wszWMDMPersistentUniqueID della risorsa di archiviazione. Per una risorsa di archiviazione specifica, l'identificatore univoco permanente fornito dal provider di servizi deve essere identico in sessioni di connessione del dispositivo diverse.

L'applicazione può chiamare FindStorage con questo identificatore univoco permanente in un secondo momento. In risposta, Windows Media Gestione dispositivi chiama questo metodo nel provider di servizi (SP).

Un identificatore univoco permanente 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. Di conseguenza, lo stesso contenuto archiviato in archivi diversi avrà identificatori univoci permanenti diversi.

Windows Media Gestione dispositivi chiama questo metodo solo per i dispositivi registrati per abilitare la sincronizzazione con Lettore multimediale Windows. Per altre informazioni, vedere Abilitazione della sincronizzazione con Lettore multimediale Windows.