IMDSPStorage4::FindStorage-Methode (mswmdm.h)

Artikel
08/25/2023

Die FindStorage-Methode sucht 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 vom 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:

Standard-COM-Fehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Der Dienstanbieter gibt einen persistenten 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 zu einem späteren Zeitpunkt mit diesem persistenten eindeutigen Bezeichner aufrufen. Als Antwort ruft Windows Media Geräte-Manager diese Methode für den Dienstanbieter auf.

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

Diese Methode ermöglicht die Suche nach einem Speicher basierend auf einem persistenten eindeutigen Bezeichner, während IMDSPStorage2::GetStorage die Suche nach einem Speicher basierend auf dem Namen ermöglicht.

Windows Media Geräte-Manager ruft diese Methode nur für Geräte auf, die mit Windows Medienwiedergabe synchronisiert werden können. Weitere Informationen finden Sie unter Aktivieren der Synchronisierung mit Windows Medienwiedergabe.