共用方式為

IVdsVDisk：：Open 方法 (vds.h)

  • 發行項

[從 Windows 8 和 Windows Server 2012 開始，虛擬磁碟服務 COM 介面會由 Windows 記憶體管理 API 取代。

開啟指定之虛擬磁碟檔案的句柄，並將 IVdsOpenVDisk 介面指標傳回代表已開啟句柄的物件。

語法

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

參數

[in] AccessMask

VIRTUAL_DISK_ACCESS_MASK旗標的位掩碼，指定要套用至已開啟虛擬磁碟的訪問許可權。

[in] Flags

OPEN_VIRTUAL_DISK_FLAG旗標的位掩碼，指定要如何開啟虛擬磁碟。

[in] ReadWriteDepth

(支援檔案的存放區數目，從備份存放區鏈結的子系開始，) 來開啟讀取/寫入。 差異鏈結中的其餘存放區將會開啟唯讀。 (這是合併作業成功的必要專案。)

[out] ppOpenVDisk

接收 IVdsOpenVDisk 介面指標的變數指標，指向新建立的物件，代表開啟至虛擬磁碟物件的句柄。 呼叫端必須藉由呼叫 IUnknown：：Release 方法不再需要介面指標時釋放介面指標。

傳回值

這個方法可以傳回標準 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 VDS 特定的傳回值。 它也可以使用 HRESULT_FROM_WIN32 宏傳回已轉換的系統錯誤碼。 錯誤可能來自 VDS 本身，或來自正在使用的基礎 VDS 提供者 。 可能的傳回值包括下列專案。

傳回碼 描述
S_OK
 已成功完成命令。

備註

應用程式必須藉由呼叫 CoInitializeSecurity 函式來初始化整個進程的安全性。 dwImpLevel 參數應該設定為 RPC_C_IMP_LEVEL_IMPERSONATE。

Windows Server 2008、Windows Vista 和 Windows Server 2003： 在 Windows 7 和 Windows Server 2008 R2 之前，不需要這些動作。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 vds.h
程式庫 Uuid.lib

另請參閱

IVdsVDisk