IMDSPDevice3::FindStorage-Methode (mswmdm.h)

Artikel
08/25/2023

Die FindStorage-Methode findet einen Speicher mit dem angegebenen persistenten eindeutigen Bezeichner. Der persistente eindeutige Bezeichner eines Speichers wird durch die g_wszWMDMPersistentUniqueID-Eigenschaft dieses Speichers beschrieben.

Syntax

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

Parameter

[in] findScope

Bereich des Suchvorgangs. Er muss einen der folgenden Werte aufweisen.

Wert	BESCHREIBUNG
WMDM_FIND_SCOPE_GLOBAL	Durchsuchen Sie das gesamte Gerät.
WMDM_FIND_SCOPE_IMMEDIATE_CHILDREN	Suchen Sie nur in den unmittelbar untergeordneten Elementen des aktuellen Speichers.

[in] pwszUniqueID

Persistenter eindeutiger Bezeichner des Speichers.

[out] ppStorage

Zeiger auf den zurückgegebenen Speicher, der durch den pwszUniqueID-Parameter angegeben wird.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Com-Standardfehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Der Dienstanbieter gibt einen dauerhaften eindeutigen Bezeichner über die g_wszWMDMPersistentUniqueID Eigenschaft des Speichers zurück. Für einen bestimmten Speicher sollte der vom Dienstanbieter bereitgestellte persistente eindeutige Bezeichner für verschiedene Geräteverbindungssitzungen identisch sein.

Die Anwendung kann FindStorage mit diesem persistenten eindeutigen Bezeichner zu einem späteren Zeitpunkt aufrufen. Als Antwort ruft Windows Media Geräte-Manager diese Methode für den Dienstanbieter (SP) auf.

Ein persistenter eindeutiger Bezeichner wird verwendet, um inhalte eindeutig zu identifizieren, die auf einem bestimmten Gerät gespeichert sind. Es stellt keinen inhaltsspezifischen global eindeutigen Bezeichner dar, der geräteübergreifend identisch bleibt. Daher verfügen dieselben Inhalte, die in verschiedenen Speicher gespeichert sind, über unterschiedliche persistente eindeutige Bezeichner.

Windows Media Geräte-Manager ruft diese Methode nur für Geräte auf, die zum Aktivieren der Synchronisierung mit Windows Medienwiedergabe registriert sind. Weitere Informationen finden Sie unter Aktivieren der Synchronisierung mit Windows Medienwiedergabe.