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
包含以下调用方提供的标志之一:
返回值
如果操作成功,该函数将返回 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 |