IMDSPDevice2::GetStorage-Methode (mswmdm.h)

Die GetStorage-Methode ermöglicht es, basierend auf seinem Namen direkt zu einem Speicher zu wechseln, anstatt alle Speicher aufzulisten, um ihn zu finden.

Syntax

HRESULT GetStorage(
  [in]  LPCWSTR      pszStorageName,
  [out] IMDSPStorage **ppStorage
);

Parameter

[in] pszStorageName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des zu suchenden Speichers enthält.

[out] ppStorage

Zeiger auf das Speicherobjekt, das durch den pszStorageName-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

Die GetStorage-Methode unterstützt keine Wildcardzeichen. Es ist nicht rekursiv, das heißt, es findet nur Speicher im Stamm des Geräts.

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 aufgezählt 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

IMDSPDevice2-Schnittstelle