IMbnConnectionProfileManager：：GetConnectionProfiles 方法 (mbnapi.h)

重要

从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的Windows 运行时 API。

获取与设备关联的连接配置文件的列表。

语法

HRESULT GetConnectionProfiles(
  [in]          IMbnInterface *mbnInterface,
  [out, retval] SAFEARRAY     **connectionProfiles
);

[in] mbnInterface

一个 IMbnInterface，表示应用配置文件请求的设备。如果此值为 NULL，则该函数将返回系统中存在的所有配置文件。

[out, retval] connectionProfiles

表示设备的所有可用连接配置文件的 IMbnConnectionProfile 接口数组。如果此方法返回 除 S_OK 以外的任何内容，则数组指针为 NULL，否则调用应用程序必须最终通过调用 SafeArrayDestroy 释放分配的内存。

此方法可以返回其中一个值。

返回代码	说明
S_OK	该方法已成功完成。
E_HANDLE	接口无效，很可能是因为移动宽带设备已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_READY)	设备未准备就绪。无法获取订阅者 ID，因为设备未 MBN_READY_STATE_INITIALIZED。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	移动宽带服务未在此系统上运行。

为特定设备调用此操作时，它将返回具有设备当前报告的相同订阅者 ID 的配置文件列表。 IMbnInterface 的 GetSubscriberInformation 方法可用于获取与接口关联的订阅者 ID。

连接配置文件与设备的订阅者 ID 相关联。对于 GSM 设备，订阅者 ID 是 SIM 卡的国际移动用户标识 (IMSI) 。对于 CDMA 设备，它是移动标识号 (MIN) 字符串或国际漫游 MIN (IRM) 字符串。