CM_Get_Device_Interface_List_SizeW函数 (cfgmgr32.h)

CM_Get_Device_Interface_List_Size 函数检索必须传递给 CM_Get_Device_Interface_List 函数的缓冲区大小。

语法

CMAPI CONFIGRET CM_Get_Device_Interface_List_SizeW(
  [out]          PULONG      pulLen,
  [in]           LPGUID      InterfaceClassGuid,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags
);

参数

[out] pulLen

调用方提供的指针指向接收缓冲区所需长度(以字符为单位)的位置,用于保存由 CM_Get_Device_Interface_List返回的多个 Unicode 字符串。

[in] InterfaceClassGuid

提供一个 GUID,用于标识 设备接口类

[in, optional] pDeviceID

调用方提供的指向 NULL 终止字符串的指针,该字符串表示 设备实例 ID。 如果指定,该函数将为指定的类检索设备接口支持的符号链接名称的长度。 如果此值 NULL,或者如果该值指向零长度字符串,则该函数将检索属于指定类的所有接口的符号链接名称的长度。

[in] ulFlags

包含以下调用方提供的标志之一:

价值 意义
CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES
该函数提供一个列表的大小,其中包含与指定 GUID 和设备实例 ID(如果有)匹配的所有设备关联的设备接口。
CM_GET_DEVICE_INTERFACE_LIST_PRESENT
该函数提供列表的大小,其中包含与当前处于活动状态的设备关联的设备接口,以及与指定的 GUID 和设备实例 ID 匹配(如果有)。

返回值

如果操作成功,该函数将返回 CR_SUCCESS。 否则,它会返回一个错误代码,其中 CR_ 前缀,如 Cfgmgr32.h 中定义。

言论

注意

cfgmgr32.h 标头将CM_Get_Device_Interface_List_Size定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Microsoft Windows 2000 及更高版本的 Windows 中可用。
目标平台 普遍
标头 cfgmgr32.h (包括 Cfgmgr32.h)
Cfgmgr32.lib
DLL CfgMgr32.dll

另请参阅

CM_Get_Device_Interface_List