IWMDMStorage4::FindStorage-Methode (mswmdm.h)

Artikel
03/04/2024

Die FindStorage-Methode ruft einen Speicher im aktuellen Stammspeicher ab, basierend auf dem persistenten eindeutigen Bezeichner.

Syntax

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

Parameter

[in] findScope

Eine WMDM_FIND_SCOPE-Enumeration , die den zu durchsuchenden Bereich angibt.

[in] pwszUniqueID

Persistenter eindeutiger Bezeichner des zu findenden Speichers. Der persistente eindeutige Bezeichner des Speichers wird durch die g_wszWMDMPersistentUniqueID Metadateneigenschaft des Speichers beschrieben.

[out] ppStorage

Zeiger auf den abgerufenen Speicher, falls gefunden. 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

Diese Methode durchsucht nur ein einzelnes Speicherobjekt (Flash-Karte oder Festplatte) auf dem Gerät.

Ein persistenter eindeutiger Bezeichner identifiziert Inhalte, 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. Ebenso können unterschiedliche Inhalte denselben persistenten eindeutigen Bezeichner aufweisen, wenn sie auf verschiedenen Geräten gespeichert werden.

Das Format des persistenten eindeutigen Bezeichners hängt vom Gerät ab. Die Anwendung muss den persistenten eindeutigen Bezeichner zuvor abgerufen haben, indem sie einen Speicher abgerufen und ihn nach ihrer WMDM/PersistentUniqueID-Eigenschaft abgefragt hat. Verwenden Sie die Methoden GetSpecifiedMetadata oder GetMetadata , um diese Eigenschaft anzufordern.