IVdsLunNumber::GetLunNumber 方法 (vdshwprv.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
标头 vdshwprv.h
Library Uuid.lib

另请参阅

IVdsLunNumber