Freigeben über


IMDSPStorageGlobals::GetCapabilities-Methode (mswmdm.h)

Die GetCapabilities-Methode ruft die Funktionen des Speichermediums ab, dem ein instance dieser Schnittstelle zugeordnet ist.

Syntax

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

Parameter

[out] pdwCapabilities

Zeiger auf ein DWORD , das die Funktionen des Speichermediums enthält.

Die folgenden Flags können im pdwCapabilities-Parameter zurückgegeben werden.

Flag Beschreibung
WMDM_STORAGECAP_FOLDERSINROOT Das Medium unterstützt Ordner im Stammverzeichnis des Speichers.
WMDM_STORAGECAP_FILESINROOT Das Medium unterstützt Dateien im Stammspeicher.
WMDM_STORAGECAP_FOLDERSINFOLDERS Das Medium unterstützt Ordner in Ordnern.
WMDM_STORAGECAP_FILESINFOLDERS Das Medium unterstützt Dateien in Ordnern.
WMDM_STORAGECAP_FOLDERLIMITEXISTS Es gibt eine beliebige Anzahl von Ordnern, die pro Form der Ordnerunterstützung durch das Medium zulässig sind.
WMDM_STORAGECAP_FILELIMITEXISTS Es gibt eine beliebige Anzahl von Dateien, die pro Form der Dateiunterstützung durch das Medium zulässig sind.
WMDM_STORAGECAP_NOT_INITIALIZABLE Das Medium kann nicht initialisiert werden. Standardmäßig kann der Speicher der obersten Ebene initialisiert werden.
 

Für geschützte Geräteimplementierungen können auch die folgenden Flags zurückgegeben werden, die die Rechtefunktionen des Mediums beschreiben.

Flag Beschreibung
WMDM_RIGHTS_PLAYBACKCOUNT Das Medium unterstützt die Beschränkung der Wiedergabeanzahl für Inhalte.
WMDM_RIGHTS_EXPIRATIONDATE Das Medium unterstützt die Ablaufdatumsnachverfolgung für Inhalte.
WMDM_RIGHTS_FREESERIALIDS Das Medium unterstützt einen kostenlosen seriellen Bezeichner für die Datei.
WMDM_RIGHTS_GROUPID Das Medium unterstützt einen Gruppenbezeichner für die Datei.
WMDM_RIGHTS_NAMEDSERIALIDS Das Medium unterstützt einen benannten seriellen Bezeichner für die Datei.

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
Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Versuche, nicht unterstützte Vorgänge auf dem Speichermedium mit der IMDSPObject-Schnittstelle auszuführen, geben einen Fehlercode zurück. Die GetCapabilities-Methode kann aufgerufen werden, um zu bestimmen, ob ein Vorgang unter normalen Umständen erfolgreich ist.

Wenn entweder das flag WMDM_STORAGECAP_FILELIMITEXISTS oder das WMDM_STORAGECAP_FOLDERLIMITEXISTS flag true ist, gibt es beliebige Grenzwerte für die Anzahl der Dateien oder Ordner, die erstellt werden können. Vorgänge über die IMDSPObject-Schnittstelle , die diese Grenzwerte überschreiten, schlagen fehl.

Diese Methode muss implementiert werden. Es darf keine WMDM_E_NOTSUPPORTED oder E_NOTIMPL zurückgeben. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.

Requirements (Anforderungen)

   
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IMDSPStorageGlobals-Schnittstelle