IMbnInterface：：GetHomeProvider 方法 (mbnapi.h)

  • 项目

重要

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

获取主提供程序。

语法

HRESULT GetHomeProvider(
  [out, retval] MBN_PROVIDER *homeProvider
);

parameters

[out, retval] homeProvider

指向表示主提供程序 的MBN_PROVIDER 结构的指针。 如果此方法返回 除 S_OK 以外的任何值，则此参数为 NULL。 完成后，调用应用程序必须通过调用 SysFreeString 释放分配给 MBN_PROVIDER 的 providerID 和 providerName 成员的内存

返回值

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

返回代码 说明
S_OK
 该方法已成功完成。 homeProvider 包含有效值。
E_PENDING
 该信息不可用。 移动宽带服务目前正在探亲获取家庭提供商。 通过注册 IMbnInterfaceEvents 的 OnHomeProviderAvailable 方法，当主提供商可用时，调用应用程序会收到通知。
E_MBN_PIN_REQUIRED
 设备要求为此操作输入 PIN。
E_MBN_SIM_NOT_INSERTED
 未插入 SIM 卡。
E_MBN_BAD_SIM
 设备中插入了错误的 SIM 卡。
HRESULT_FROM_WIN32 (ERROR_READ_FAULT)
无法从 SIM 卡或设备内存中读取数据。 例如，SIM 未预配主提供商信息。

注解

GetHomeProvider 返回设备的主提供商信息。 应忽略返回MBN_PROVIDER结构的 dataClass 字段。

对于 E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED和 E_MBN_BAD_SIM的可恢复错误，当错误条件结束时，移动宽带服务将再次查询设备以查找家庭提供商。 例如，如果设备需要输入 PIN 才能检索此信息，则它将返回 E_MBN_PIN_REQUIRED。 当应用程序输入 PIN 以解锁设备时，移动宽带服务将再次尝试从设备获取此信息。 系统将通过调用 IMbnInterfaceEvents 的 OnHomeProviderAvailable 方法更新有关新查询状态的应用程序。

当主提供程序信息可用或新查询完成时，可以调用 IMbnInterfaceEvents 的已注册 OnHomeProviderAvailable 方法。 此函数返回成功后，此信息将永远不会更改。

要求

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

另请参阅

IMbnInterface