IWMDMDevice3::FindStorage-Methode (mswmdm.h)

Artikel
03/04/2024

Die FindStorage-Methode findet einen Speicher anhand ihres persistenten eindeutigen Bezeichners. Im Gegensatz zu anderen Methoden kann diese Methode rekursiv aus dem Stammspeicher suchen.

Syntax

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

Parameter

[in] findScope

Eine WMDM_FIND_SCOPE Enumeration, die den Bereich des Suchvorgangs angibt.

[in] pwszUniqueID

Eine Zeichenfolge mit breitem Zeichen mit NULL-Beendigung, die einen dauerhaften eindeutigen Bezeichner des Speichers darstellt, der durch Abfragen nach der g_wszWMDMPersistentUniqueID Eigenschaft des Speichers abgerufen werden kann.

[out] ppStorage

Zeiger auf den zurückgegebenen Speicher. Der Aufrufer muss diese Schnittstelle freigeben, wenn er damit fertig ist.

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

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. Auf ähnliche Weise können unterschiedliche Inhalte denselben persistenten eindeutigen Bezeichner aufweisen, wenn sie auf verschiedenen Geräten gespeichert werden. Bei verwendung der Analogie von Inhalten auf einem Gerät, die Zeilen in einer Datenbank ähneln, dient diese Eigenschaft demselben Zweck wie die Identitätsspalte in einer Datenbank.

Da sie vom Gerät generiert wird, ist das Format des persistenten eindeutigen Bezeichners geräteabhängig. Die Anwendung sollte den persistenten eindeutigen Bezeichner abrufen, indem sie die g_wszWMDMPersistentUniqueID Eigenschaft des Speichers abfragt. Eine Anwendung kann die Methoden GetSpecifiedMetadata oder GetMetadata verwenden, um diese Eigenschaft abzufragen.