IMDSPObject::Open-Methode (mswmdm.h)

Artikel
08/25/2023

Die Open-Methode öffnet das zugeordnete Objekt und bereitet es für Lese- oder Schreibvorgänge vor. Dieser Vorgang ist nur gültig, wenn das Speicherobjekt eine Datei darstellt.

Syntax

HRESULT Open(
  [in] UINT fuMode
);

Parameter

[in] fuMode

Modus, in dem die Datei geöffnet werden muss. Es muss sich um einen der folgenden beiden Werte handeln.

Wert	BESCHREIBUNG
MDSP_READ	Fragen Sie ab, ob ein nachfolgender Aufruf von Read zulässig wäre.
MDSP_WRITE	Fragen Sie ab, ob ein nachfolgender Aufruf von Insert zulässig ist.

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

Wenn das zugrunde liegende Dateisystem das gleichzeitige Öffnen mehrerer Dateien nicht unterstützt, sollte der Dienstanbieter den Win32-Fehlercode ordnungsgemäß ERROR_TOO_MANY_OPEN_FILES zurückgeben, wenn der Client versucht, mehrere Dateien gleichzeitig zu öffnen.

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.