共用方式為

IVdsLunControllerPorts：：AssociateControllerPorts 方法 （vds.h）

[從 Windows 8 和 Windows Server 2012 開始， 虛擬磁碟服務 COM 介面被 Windows 儲存管理 API 取代。]

將子系統控制器埠相對於 LUN 設定為主動或非活躍。 此方法取代 了 IVdsLun：：AssociateControllers。

語法

HRESULT AssociateControllerPorts(
  VDS_OBJECT_ID *pActiveControllerPortIdArray,
  LONG          lNumberOfActiveControllerPorts,
  VDS_OBJECT_ID *pInactiveControllerPortIdArray,
  LONG          lNumberOfInactiveControllerPorts
);

參數

pActiveControllerPortIdArray

一個指向控制器埠 GUID 陣列的指標。 提供者會將這些控制器埠設為啟用。 此陣列包含已設定為啟用且將持續啟用的控制器埠。

lNumberOfActiveControllerPorts

pActiveControllerPortIdArray 參數中指定的控制器埠數。

pInactiveControllerPortIdArray

一個指向控制器埠 GUID 陣列的指標。 提供者會將這些控制器埠設為非啟用。 此陣列包含已設定為非啟用的控制器埠，且這些埠將保持非啟用狀態。

lNumberOfInactiveControllerPorts

pInactiveControllerPortIdArray 參數中指定的控制器埠數。

返回值

此方法可回傳標準 HRESULT 值，如 E_INVALIDARG 或 E_OUTOFMEMORY，以及 VDS 專屬的回傳值。 它也能利用HRESULT_FROM_WIN32巨集回傳轉換後的系統錯誤碼。 錯誤可能來自 VDS 本身，或來自所使用的底層 VDS 提供者 。 可能的回傳值包括以下幾項。

傳回碼/值 Description
S_OK
 協會名稱成功確立。
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 提供者的快取已經損壞。 這表示供應商內部存在軟體或通訊問題，會快取連接裝置的資訊。 呼叫者可以使用 IVdsHwProvider：：Reenumerate 方法，接著 IVdsHwProvider：：Refresh 方法來還原快取。
VDS_E_OBJECT_DELETED
0x8004240BL
 LUN 物件已不存在。
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 LUN 處於失敗狀態，無法執行所請求的操作。
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
 另一項手術正在進行中。 此操作必須完成前一操作才能繼續。
VDS_E_OBJECT_NOT_FOUND
0x80042405L
 pActiveControllerPortIdArray 或 pInactiveControllerPortIdArray 參數VDS_OBJECT_ID中指定的一個或多個資料型別 GUID，並不指涉現有物件。
VDS_E_NOT_SUPPORTED
0x80042400L
 此操作或參數組合不被此提供者支援。

需求

Requirement 價值觀
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 R2 [僅限傳統型應用程式]
目標平臺 窗戶
Header VDS.H
可再發行 VDS 1.1

另請參閱

IVdsLunControllerPorts

  • Last updated on