IMbnConnectionProfileManager：：GetConnectionProfile 方法 (mbnapi.h)

重要

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

获取与给定移动宽带设备关联的特定连接配置文件。

语法

HRESULT GetConnectionProfile(
  [in]          IMbnInterface         *mbnInterface,
  [in]          LPCWSTR               profileName,
  [out, retval] IMbnConnectionProfile **connectionProfile
);

参数

[in] mbnInterface

一个 IMbnInterface，表示应用配置文件请求的设备。 如果 mbnInterface 为 NULL，则此函数将返回与系统中任何设备关联的给定名称的配置文件。

[in] profileName

一个以 null 结尾的字符串，其中包含连接配置文件的名称。

[out, retval] connectionProfile

表示所需连接配置文件的 IMbnConnectionProfile 接口。 如果此方法返回 除 S_OK 以外的任何内容，则为 NULL。

返回值

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

返回代码	说明
S_OK	该方法已成功完成。
E_HANDLE	接口无效，很可能是因为移动宽带设备已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	具有给定名称的配置文件不存在。
HRESULT_FROM_WIN32 (ERROR_NOT_READY)	设备未准备就绪。 无法获取订阅者 ID，因为设备未 MBN_READY_STATE_INITIALIZED。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	具有给定名称的配置文件不存在。

注解

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

如果已使用 CreateConnectionProfile 创建新配置文件，则调用方必须等待 接收 OnConnectionProfileArrival 事件，然后使用新配置文件的名称调用 GetConnectionProfile ;否则， GetConnectionProfile API 调用可能会失败 ，HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) 。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	mbnapi.h

另请参阅

IMbnConnectionProfileManager