IVdsLunNumber：：GetLunNumber 方法 (vdshwprv.h)

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

擷取 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
標頭	vdshwprv.h
程式庫	Uuid.lib

另請參閱

IVdsLunNumber