IVdsLunNumber：：GetLunNumber 方法 (vds.h)

  • 發行項

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

擷取 LUN 的 LUN 編號。

語法

HRESULT GetLunNumber(
  [out] ULONG *pulLunNumber
);

參數

[out] pulLunNumber

接收 LUN 編號的變數位址。 這個值是必要的，而且不能是 NULL。

傳回值

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

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

備註

這個方法會傳回 VDS 硬體提供者指派給 LUN 的 LUN 編號。 此數位會識別磁碟陣列內的 LUN。 它與磁碟 SCSI 位址中的「邏輯單元編號」不同。 磁碟陣列中的每個 LUN 都只指派一個 LUN 編號。

這個方法存在，因為 DiskRAID 公用程式在列舉子系統中的 LUN 時，會將自己的索引指派給每個 LUN。 但是，如果硬體提供者以不同的順序列舉 LUN，這些索引可以在每次執行 DiskRAID 時變更。 這可能會對終端使用者造成混淆。 對於具有自己 (提供者指派) LUN 號碼的磁碟陣列，這個方法可讓呼叫端能夠將 LUN 號碼對應至 DiskRAID 所指派的 LUN 索引。

如果子系統支援 LUN 編號，它可以藉由在 VDS_SUB_SYSTEM_PROP 或 VDS_SUB_SYSTEM_PROP2 結構的 ulFlags 成員中設定 VDS_SF_SUPPORTS_LUN_NUMBER 旗標來指出此支援。 如需此旗標的詳細資訊，請參閱 VDS_SUB_SYSTEM_FLAG 列舉。

規格需求

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

另請參閱

IVdsLunNumber