IVdsVDisk::Open-Methode (vds.h)

  • Artikel

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Öffnet ein Handle für die angegebene Datei des virtuellen Datenträgers und gibt einen IVdsOpenVDisk-Schnittstellenzeiger auf das Objekt zurück, das das geöffnete Handle darstellt.

Syntax

HRESULT Open(
  [in]  VIRTUAL_DISK_ACCESS_MASK AccessMask,
  [in]  OPEN_VIRTUAL_DISK_FLAG   Flags,
  [in]  ULONG                    ReadWriteDepth,
  [out] IVdsOpenVDisk            **ppOpenVDisk
);

Parameter

[in] AccessMask

Eine Bitmaske von VIRTUAL_DISK_ACCESS_MASK Flags, die die Zugriffsrechte angeben, die auf den geöffneten virtuellen Datenträger angewendet werden sollen.

[in] Flags

Eine Bitmaske von OPEN_VIRTUAL_DISK_FLAG Flags, die angeben, wie der virtuelle Datenträger geöffnet werden soll.

[in] ReadWriteDepth

Die Anzahl der Speicher (sichernde Dateien), beginnend mit dem untergeordneten Element, der Sicherungsspeicherkette zum Öffnen von Lese-/Schreibzugriff. Die verbleibenden Filialen in der Differenzierungskette werden schreibgeschützt geöffnet. (Dies ist erforderlich, damit Mergevorgänge erfolgreich ausgeführt werden können.)

[out] ppOpenVDisk

Ein Zeiger auf eine Variable, die einen IVdsOpenVDisk-Schnittstellenzeiger auf das neu erstellte Objekt empfängt, das das handle darstellt, das für das Objekt des virtuellen Datenträgers geöffnet wurde. Aufrufer müssen den Schnittstellenzeiger freigeben, wenn er nicht mehr benötigt wird, indem sie die IUnknown::Release-Methode aufrufen.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.

Bemerkungen

Anwendungen müssen die prozessweite Sicherheit initialisieren, indem sie die CoInitializeSecurity-Funktion aufrufen. Der dwImpLevel-Parameter sollte auf RPC_C_IMP_LEVEL_IMPERSONATE festgelegt werden.

Windows Server 2008, Windows Vista und Windows Server 2003: Diese Aktionen sind erst unter Windows 7 und Windows Server 2008 R2 erforderlich.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vds.h
Bibliothek Uuid.lib

Weitere Informationen

IVdsVDisk