IMbnServiceActivation::Activate 方法 (mbnapi.h)

重要

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

将服务激活请求发送到网络。

语法

HRESULT Activate(
  [in]  SAFEARRAY *vendorSpecificData,
  [out] ULONG     *requestID
);

参数

[in] vendorSpecificData

在服务激活操作中传递的特定于供应商的字节数组。 此数据将由移动宽带服务在 SET OID_WWAN_SERVICE_ACTIVATION OID 请求中传递给微型端口驱动程序。

[out] requestID

此操作的请求 ID。

返回值

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

返回代码 说明
S_OK
该方法已成功完成。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
移动宽带服务未在此系统上运行。
E_HANDLE
接口无效。 设备很可能已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
接口无效。 很可能移动宽带设备已从系统中删除。

接口无效。 设备很可能已从系统中删除。

注解

应用程序可以使用 Activate 方法激活手机网络服务。 此请求中传递的数据的格式特定于供应商。

OID 请求的 VendorSpecificBufferSize 字段将设置为 SAFEARRAY、 vendorSpecificData 中的数据大小。 vendorSpecificData 的内容将在 OID 请求中逐字节复制到驱动程序。

有关服务激活操作的详细信息,请参阅移动宽带驱动程序模型。

这是将立即返回的异步操作。 如果方法返回时没有错误,则移动宽带服务将调用 IMbnServiceActivationEvents 接口的 OnActivationComplete 方法。

要求

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

另请参阅

IMbnServiceActivation