IMbnServiceActivationEvents::OnActivationComplete 方法 (mbnapi.h)

重要

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

移动宽带服务调用的通知方法,指示服务激活请求已完成。

语法

HRESULT OnActivationComplete(
  [in] IMbnServiceActivation *serviceActivation,
  [in] SAFEARRAY             *vendorSpecificData,
  [in] ULONG                 requestID,
  [in] HRESULT               status,
  [in] ULONG                 networkError
);

参数

[in] serviceActivation

指向 IMbnServiceActivation 接口的指针,该接口表示执行请求的设备。

[in] vendorSpecificData

包含 NDIS_STATUS_WWAN_SERVICE_ACTIVATION中基础移动宽带微型端口驱动程序返回的数据的字节数组。

[in] requestID

初始化请求时移动宽带服务分配的请求 ID。

[in] status

完成状态。

调用应用程序可能需要以下值之一。

含义
S_OK
操作成功。
E_INVALIDARG
微型端口驱动程序在请求中检测到不正确的输入数据。
E_MBN_PIN_REQUIRED
需要 PIN 才能完成操作。
E_MBN_RADIO_POWER_OFF
移动宽带设备未通电。
E_MBN_PROVIDER_NOT_VISIBLE
服务提供商不可见。
E_MBN_SIM_NOT_INSERTED
设备中没有 SIM 卡。
E_MBN_BAD_SIM
设备中有一个错误的 SIM 卡。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
设备不支持此操作。

[in] networkError

网络在激活操作期间返回的错误代码。 仅当 状态 不S_OK时,此值才有意义。

networkError 的确切值依赖于驱动程序/网络。

返回值

此方法必须返回 S_OK

注解

成功激活服务还会导致设备的就绪状态发生更改。 移动宽带服务将调用 IMbnInterfaceEventsOnReadyStateChange 方法作为通知。

要求

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

另请参阅

IMbnServiceActivationEvents