啟動和服務物件

  • 發行項

[從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_FLAG， VDS_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 埠物件

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

載入 VD

IVdsService：：GetObject

VDS 通知