IMDSPStorage4::FindStorage-Methode (mswmdm.h)
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
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |
Weitere Informationen
Aktivieren der Synchronisierung mit Windows Medienwiedergabe