OPEN_VIRTUAL_DISK_PARAMETERS 結構 (virtdisk.h)

包含虛擬磁碟開啟要求參數。

語法

typedef struct _OPEN_VIRTUAL_DISK_PARAMETERS {
  OPEN_VIRTUAL_DISK_VERSION Version;
  union {
    struct {
      ULONG RWDepth;
    } Version1;
    struct {
      BOOL GetInfoOnly;
      BOOL ReadOnly;
      GUID ResiliencyGuid;
    } Version2;
  };
} OPEN_VIRTUAL_DISK_PARAMETERS, *POPEN_VIRTUAL_DISK_PARAMETERS;

成員

Version

OPEN_VIRTUAL_DISK_VERSION 列舉，指定要傳遞至 VHD 函式或從 VHD 函式傳遞OPEN_VIRTUAL_DISK_PARAMETERS結構的版本。

值	意義
OPEN_VIRTUAL_DISK_VERSION_1 1	使用這個 結構的 Version1 成員。
OPEN_VIRTUAL_DISK_VERSION_2 2	使用這個 結構的 Version2 成員。

Version1

如果 版本 成員 OPEN_VIRTUAL_DISK_VERSION_1 ( 1) ，則會使用此結構。

Version1.RWDepth

指出備份存儲鏈結的子系以讀取/寫入方式開啟的存放區數目。 差異鏈結中的其餘存放區將會以唯讀方式開啟。 這是合併作業成功的必要專案。

值	意義
0	請勿在任何深度開啟讀取/寫入。 此值應該用於唯讀作業。
OPEN_VIRTUAL_DISK_RW_DEPTH_DEFAULT 1	如果不需要其他值，則為要使用的預設值。
n (使用者定義的)	如果預期合併作業，這個整數值應該是合併層級數目加上一個。

Version2

如果 版本 成員 OPEN_VIRTUAL_DISK_VERSION_2 ( 2) ，則會使用此結構。

Windows 7 和 Windows Server 2008 R2： 在 Windows 8 和 Windows Server 2012 之前，不支援此結構。

Version2.GetInfoOnly

如果為 TRUE，表示句柄只用來取得虛擬磁碟的相關信息。

Version2.ReadOnly

如果為 TRUE，表示檔案備份儲存區是以唯讀方式開啟。

Version2.ResiliencyGuid

開啟檔案時要指定的復原 GUID 。

注意

下列開頭為 Version3 的參數是供內部使用。

Version3

Version3.GetInfoOnly

Version3.ReadOnly

Version3.ResiliencyGuid

Version3.SnapshotId

規格需求

需求	值
最低支援的用戶端	Windows 7
最低支援的伺服器	Windows Server 2008 R2
標頭	virtdisk.h

另請參閱

關於 VHD

OpenVirtualDisk

VHD 參考