CM_Get_Device_Interface_AliasA 函数 (cfgmgr32.h)

  • 项目

如果别名存在， CM_Get_Device_Interface_Alias 函数将返回指定设备接口实例的别名。

语法

CMAPI CONFIGRET CM_Get_Device_Interface_AliasA(
  [in]      LPCSTR pszDeviceInterface,
  [in]      LPGUID AliasInterfaceGuid,
  [out]     LPSTR  pszAliasDeviceInterface,
  [in, out] PULONG pulLength,
  [in]      ULONG  ulFlags
);

参数

[in] pszDeviceInterface

指向要为其检索别名的设备接口实例名称的指针。 调用方通常从调用 CM_Get_Device_Interface_List 或 PnP 通知结构接收此字符串。

[in] AliasInterfaceGuid

指向 GUID 的指针，指定要检索的别名的接口类。

[out] pszAliasDeviceInterface

指定指向缓冲区的指针，该指针在成功返回时指向包含别名名称的字符串。 当不再需要此字符串时，调用方必须释放该字符串。

需要缓冲区。 否则，调用将失败。

[in, out] pulLength

提供 pszAliasDeviceInterface 中的字符计数，并接收保存别名设备接口所需的字符数。

输入时，此参数必须大于 0。

[in] ulFlags

保留。 请勿使用。

返回值

如果操作成功，函数将返回CR_SUCCESS。 否则，它将返回 Cfgmgr32.h 中定义的CR_前缀错误代码之一。

返回代码 说明
CR_NO_SUCH_DEVICE_INTERFACE
 可能指示指定接口类没有别名。
CR_OUT_OF_MEMORY
 内存不足，无法完成此操作。
CR_BUFFER_SMALL
 传递的缓冲区太小。

注解

如果设备接口由同一基础设备公开，并且具有相同的接口引用字符串，但属于不同的接口类，则设备接口被视为别名。

pszDeviceInterface 参数为属于特定接口类的特定设备指定设备接口实例，其中包含特定的引用字符串。 CM_Get_Device_Interface_Alias 为同一设备和引用字符串返回另一个设备接口实例，但返回不同的接口类（如果存在）。

例如，容错卷的函数驱动程序可以注册并设置两个设备接口，其中一个是容错卷接口类，一个是卷接口类。 另一个驱动程序可以使用其中一个接口的符号链接调用 CM_Get_Device_Interface_Alias ，并通过指定另一个接口的接口类来询问是否存在。

如果两个具有 NULL 引用字符串的设备接口由同一基础设备公开，并且具有不同的接口类 GUID，则它们是别名。

要求

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