IVdsOpenVDisk::Attach-Methode (vds.h)

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

Fügt einen virtuellen Datenträger an.

Syntax

HRESULT Attach(
  [in]  LPWSTR                   pStringSecurityDescriptor,
  [in]  ATTACH_VIRTUAL_DISK_FLAG Flags,
  [in]  ULONG                    ProviderSpecificFlags,
  [in]  ULONG                    TimeoutInMs,
  [out] IVdsAsync                **ppAsync
);

Parameter

[in] pStringSecurityDescriptor

Eine Zeichenfolge, die den Sicherheitsdeskriptor für den virtuellen Datenträger enthält. Wenn nicht angegeben, wird der verwendete Sicherheitsdeskriptor verwendet: "D:P(A;; GA;;; WD)" unter Windows 7 und "D:P(A;; GA;;; WD)(A;; GA;;; AC)" auf Windows 8.1 und höher.

[in] Flags

Eine Bitmaske mit ATTACH_VIRTUAL_DISK_FLAG Enumerationswerten, die angeben, wie der virtuelle Datenträger angefügt werden soll. Die folgenden Werte sind möglich.

[in] ProviderSpecificFlags

Eine Bitmaske von Flags, die für den Typ des angefügten virtuellen Datenträgers spezifisch sind. Diese Flags sind anbieterspezifisch. Für den Anbieter virtueller Microsoft-Datenträger muss dieser Parameter 0 (null) sein.

[in] TimeoutInMs

Dieser Parameter ist für die zukünftige Verwendung reserviert.

[out] ppAsync

Ein Zeiger auf eine IVdsAsync-Schnittstelle , die nach erfolgreichem Abschluss die IVdsAsync-Schnittstelle empfängt, um diesen Vorgang zu überwachen und zu steuern. Aufrufer müssen die empfangene Schnittstelle freigeben, wenn sie damit fertig sind. Wenn die IVdsAsync::Wait-Methode für die Schnittstelle aufgerufen wird und ein erfolgreicher HRESULT-Wert zurückgegeben wird, müssen die in der VDS_ASYNC_OUTPUT-Struktur zurückgegebenen Schnittstellen durch Aufrufen der IUnknown::Release-Methode für jeden Schnittstellenzeiger freigegeben werden. Wenn Wait jedoch einen HRESULT-Fehlerwert zurückgibt oder der pHrResult-Parameter von Wait einen HRESULT-Fehlerwert empfängt, sind die Schnittstellenzeiger in der VDS_ASYNC_OUTPUT-StrukturNULL und müssen nicht freigegeben werden. Sie können HRESULT-Werte für Erfolg oder Fehler testen, indem Sie die in Winerror.h definierten Makros SUCCEEDED und FAILED verwenden.

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 makros HRESULT_FROM_WIN32 zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Bemerkungen

Wenn ein virtueller Datenträger angefügt ist, kann der Aufrufer eine oder alle der folgenden Benachrichtigungen erhalten:

• Wenn der Anrufer für VDS-Benachrichtigungen registriert ist, erhält der Anrufer eine Datenträgerankunftsbenachrichtigung. Weitere Informationen finden Sie unter VDS-Benachrichtigungen.
• Wenn der Aufrufer für PnP-Benachrichtigungen registriert ist, erhält der Anrufer eine PnP-Datenträgerankunftsbenachrichtigung. Weitere Informationen finden Sie unter RegisterDeviceNotification.

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

Anforderungen

Weitere Informationen

IVdsOpenVDisk