IMDSPStorage2::GetStorage-Methode (mswmdm.h)
Die GetStorage-Methode ermöglicht es, von einem Speichernamen aus direkt zu einem Speicherobjekt zu wechseln, anstatt alle Speicher aufzulisten, um es zu finden.
Syntax
HRESULT GetStorage(
[in] LPCWSTR pszStorageName,
[out] IMDSPStorage **ppStorage
);
Parameter
[in] pszStorageName
Zeiger auf eine NULL-beendete Zeichenfolge, die den Speichernamen enthält.
[out] ppStorage
Zeiger auf das durch pszStorageName angegebene Speicherobjekt oder NULL , wenn kein solcher Speicher gefunden wurde.
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
Hinweise
Die IMDSPStorage2::GetStorage-Schnittstelle erweitert die Funktionalität von IMDSPStorage.
IMDSPStorage2::GetStorage unterstützt keine Wildcardzeichen. Es ist nicht rekursiv, das heißt, es findet nur Speicherobjekte im aktuellen Speicher.
Wenn diese Methode nicht implementiert ist, sollte sie E_NOTIMPL zurückgeben. (Es sollte keine WMDM_E_NOT_SUPPORTED oder andere Codes zurückgeben, die angeben, dass diese Methode nicht implementiert ist).) Dadurch wird sichergestellt, dass Windows Media Geräte-Manager versucht, diese Funktionalität selbst zu ersetzen, indem alle Speicher aufgelistet werden, um eine Übereinstimmung basierend auf dem als pszStorageName übergebenen Speichernamen zu finden.
Es wird dringend empfohlen, dass ein Dienstanbieter diese Methode implementiert, um ein Speicherobjekt basierend auf dem Namen effizient zurückzugeben.
Diese Methode ist optional. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | mswmdm.h |
| Bibliothek | Mssachlp.lib |