Metodo IMDSPStorage4::FindStorage (mswmdm.h)

Articolo
02/29/2024

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 lo stesso in diverse sessioni di connessione del dispositivo.

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.

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.

Questo metodo consente di cercare una risorsa di archiviazione basata su un identificatore univoco permanente, mentre IMDSPStorage2::GetStorage consente di cercare una risorsa di archiviazione basata sul nome.

Windows Media Gestione dispositivi chiama questo metodo solo per i dispositivi che possono essere sincronizzati con Lettore multimediale Windows. Per altre informazioni, vedere Abilitazione della sincronizzazione con Lettore multimediale Windows.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	mswmdm.h
Libreria	Mssachlp.lib

Vedi anche

Abilitazione della sincronizzazione con Lettore multimediale Windows

IMDSPStorage2::GetStorage

Interfaccia IMDSPStorage4

Condividi tramite