共用方式為

啟動和服務物件

  • 發行項

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

VDS 提供對象來執行服務相關活動。 本主題描述每個物件。

服務載入器物件

服務載入器物件會提供應用程式用來載入和初始化 VDS 的方法。 若要準備 VDS 以供使用，應用程式必須執行下列作業：

如需程式代碼範例，請參閱 載入 VDS。

一律允許服務完全初始化，再呼叫服務對象公開的方法。 使用 IVdsService：：IsServiceReady 方法來判斷載入進程的狀態。 使用 IVdsService：：WaitForServiceReady 方法來封鎖對 VDS 物件的呼叫，直到初始化完成為止。

下表列出相關的介面、列舉和結構。

類型 元素
這個物件一律公開的介面 IVdsServiceLoader。
相關聯的列舉 沒有。
相關聯的結構 沒有。

 

Service 物件

服務物件是所有 VDS 應用程式的核心多功能物件。 使用此物件時，呼叫端可以執行下列作業：

  • 判斷服務初始化的狀態。
  • 擷取向 VDS 註冊的所有硬體或軟體提供者。
  • 報告未配置磁碟。
  • 傳回與磁碟上磁碟區相關聯的文件系統類型和驅動器號。
  • 從登錄中移除未使用的使用者模式路徑和掛接的資料夾，然後重新整理磁碟。
  • 接收 VDS 通知。
  • 重新啟動主機。
  • 擷取本機電腦上的光纖通道 HBA 埠或 iSCSI 啟動器配卡。
  • 安全地準備公開為本機電腦上的磁碟的 LUN 以進行移除。

VDS 通知結構會將物件 GUID 傳遞給所有向 VDS 註冊的應用程式，以接收通知。 使用 IVdsService：：GetObject 方法，將物件 GUID 轉換成對象指標。 如需通知模型更完整的描述，請參閱 VDS 通知。

下表列出相關的介面、列舉和結構。

類型 元素
這個物件一律公開的介面 IVdsService、IVdsServiceHba*、IVdsServiceIscsi*、IVdsServiceUninstallDisk*。
一律實作但未公開給應用程式的介面 IVdsAdmin
相關聯的列舉 VDS_QUERY_PROVIDER_FLAG、VDS_OBJECT_TYPE、VDS_SERVICE_FLAG、VDS_DRIVE_LETTER_FLAG、VDS_FILE_SYSTEM_FLAGVDS_FILE_SYSTEM_PROP_FLAG。
相關聯的結構 VDS_SERVICE_PROP、VDS_FILE_SYSTEM_PROP、VDS_FILE_SYSTEM_TYPE_PROP、VDS_DRIVE_LETTER_NOTIFICATION、VDS_FILE_SYSTEM_NOTIFICATIONVDS_MOUNT_POINT_NOTIFICATION。

 

*Windows Server 2003： Windows Server 2003 R2 之前不支持這些介面。

啟動器配接器物件

啟動器配接器物件會在 VDS 服務的主電腦上建立 iSCSI 啟動器配接器模型。 VDS 服務只能在本機計算機上檢視啟動器配接器。 啟動器配接器物件的角色是管理從本機計算機到iSCSI目標的登入工作階段。

下表列出相關的介面、列舉和結構。

類型 元素
這個物件一律公開的介面 IVdsIscsiInitiatorAdapter*.
相關聯的列舉 VDS_ISCSI_LOGIN_TYPE。 VDS_ISCSI_LOGIN_FLAGVDS_ISCSI_AUTH_TYPE。
相關聯的結構 VDS_ISCSI_INITIATOR_ADAPTER_PROP。

 

*Windows Server 2003： Windows Server 2003 R2 之前不支援此介面。

啟動器入口網站物件

啟動器入口網站物件會在iSCSI啟動器上建立iSCSI啟動器入口網站的模型。 啟動器入口網站是IP位址和埠的組合，主電腦透過該埠連接到iSCSI子系統上的入口網站。 啟動器入口網站物件的角色是做為 MPIO 路徑的其中一個端點，以及設定 IPSEC 安全性設定。

下表列出相關的介面、列舉和結構。

類型 元素
這個物件一律公開的介面 IVdsIscsiInitiatorPortal*.
相關聯的列舉 VDS_ISCSI_IPSEC_FLAG。
相關聯的結構 VDS_ISCSI_INITIATOR_PORTAL_PROP、VDS_ISCSI_IPSEC_KEY、VDS_IPADDRESS。

 

*Windows Server 2003： Windows Server 2003 R2 之前不支援此介面。

HBA Port 物件

HBA 埠物件會建立光纖通道主機總線適配卡 （HBA） 埠的模型。

使用 IVdsServiceHba：：QueryHbaPorts 方法來判斷本機電腦上 VDS 已知的 HBA 埠。

下表列出相關的介面、列舉和結構。

類型 元素
這個物件一律公開的介面 IVdsHbaPort*.
相關聯的列舉 VDS_HBAPORT_TYPE、VDS_HBAPORT_STATUS、VDS_HBAPORT_SPEED_FLAG。
相關聯的結構 VDS_HBAPORT_PROP。

 

*Windows Server 2003： Windows Server 2003 R2 之前不支援此介面。

VDS 物件模型

IVdsServiceLoader：：LoadService

載入 VDS

IVdsService：：GetObject

VDS 通知