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

Weitere Informationen

IMDSPStorage-Schnittstelle

IMDSPStorage2-Schnittstelle