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。 否则，它将返回 cfgmgr32.h 中定义的 具有 CR_ 前缀的错误代码之一。

注解

注意

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

要求

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

另请参阅

CM_Get_Device_Interface_List