OID_WWAN_CONNECT

OID_WWAN_CONNECT激活或停用特定数据包上下文，并读取上下文的激活状态。

微型端口驱动程序必须异步处理集和查询请求，最初将NDIS_STATUS_INDICATION_REQUIRED返回到原始请求，然后发送包含NDIS_WWAN_CONTEXT_STATE结构的NDIS_STATUS_WWAN_CONTEXT_STATE状态通知，该结构指示数据包数据协议 (PDP) MB 设备的上下文状态，而不考虑完成集或查询请求。

请求设置数据包数据协议 (PDP) MB 设备的上下文状态的调用方向微型端口驱动程序提供具有相应信息的 NDIS_WWAN_SET_CONTEXT_STATE 结构。

注解

有关使用此 OID 的详细信息，请参阅 WWAN 数据包上下文管理。

此对象激活或停用特定的数据包上下文，并读取上下文的激活状态。 每当激活状态发生更改时，微型端口驱动程序都必须发送相应的事件通知。

仅当微型端口驱动程序处于 WwanRegisterStateHome、WwanRegisterStatePartner 或 WwanRegisterStateRoaming 的注册状态时，才会调用此对象。 当数据包服务处于活动状态时，设备还必须处于 WwanPacketServiceStateAttached 的附加状态。

此对象支持设置和查询操作。

• 处理设置的请求需要网络访问，但不需要 SIM 卡访问。

• 处理查询请求不需要访问网络或 SIM 卡。

此 OID 的数据结构NDIS_WWAN_SET_CONTEXT_STATE。 微型端口驱动程序会针对集请求和查询请求发出NDIS_STATUS_WWAN_CONTEXT_STATE状态指示。

在此版本的驱动程序模型中，微型端口驱动程序仅按照 MB 服务指示尝试上下文激活。 (微型端口驱动程序可能会激活在更高版本中由网络启动的上下文。) 微型端口驱动程序不得在丢失注册或信号后自动激活上下文。 如果在激活请求中未提供访问字符串，微型端口驱动程序不应尝试提供默认字符串。 相反，它必须继续使用空白访问字符串激活上下文。

另一方面，微型端口驱动程序可能会根据 MB 服务的指示停用上下文。 如果网络连接丢失的时间超过了暂时丢失信号的阈值，或者作为正常关闭或状态清理的一部分，则可能会发生这种情况。

由于此版本中仅支持一个已激活的上下文，因此激活或停用特定上下文相当于设置或拆除第 2 MB 层连接。

在设置请求时，MB 服务在WWAN_CONTEXT_STATE数据结构中提供 ConnectionId 和 ActivationCommand 参数。 它指示微型端口驱动程序根据 ActivationCommand 参数值 WwanActivationCommandActivate 或 WwanActivationCommandDeactivate 激活或停用 ConnectionId 标识的数据包上下文。

• 如果服务或订阅需要激活，微型端口驱动程序应WWAN_STATUS_SERVICE_NOT_ACTIVATED返回错误代码。 在激活服务或订阅之前，PDP 激活可能不会发生。 所有紧急服务都可能都可用，但需要设备和操作员的支持。 操作系统可能会调用 OID_WWAN_SERVICE_ACTIVATION 以响应此错误代码。

• 如果微型端口驱动程序在当前激活另一个数据包上下文时收到上下文激活请求，则会WWAN_STATUS_MAX_ACTIVATED_CONTEXTS返回错误代码。

• 如果微型端口驱动程序收到上下文停用请求，但 ConnectionId 标识的上下文当前未激活，则会WWAN_STATUS_CONTEXT_NOT_ACTIVATED返回错误代码。

微型端口驱动程序使用以下逻辑确定设置请求中 AccessString、UserName 和 Password 设置的有效性：

• 如果 ActivationCommand 为 WwanActivationCommandDeactivate，微型端口驱动程序应忽略这三个参数的设置。 其余情况仅考虑 ActivationCommand 为 WwanActivationCommandActivate 的情况。

上下文激活在用户登录和注销时持续存在。 它不是按登录用户。

在查询请求中，MB 服务使用此对象来查找激活状态。

为了响应查询请求，微型端口驱动程序会发送NDIS_STATUS_WWAN_CONTEXT_STATE通知。

重要 注意：

在极少数但特定情况下，Windows 7 上的 MB 服务可能会尝试在预先存在的连接确定到 Internet 的连接之前或预先存在的连接的 Internet 连接暂时中断时自动连接。 这可能会导致同时建立 MB 和 WLAN/以太网连接。 例如，当同时尝试 MB 和其他连接，并且网络列表管理器服务仍在尝试使用主动和被动方法确定其他连接的 Internet 连接时，可能会发生这种情况。 也可能是由于网络基础结构（如公司代理服务器或 ISP 网络）的临时中断导致的。 因此，无论是否选择了“仅当没有可用的备用 Internet 连接时自动连接”选项，MB 服务都可能会尝试自动连接到 Internet。

要求

版本	在 Windows 7 和更高版本的 Windows 中可用。
标头	Ntddndis.h (包括 Ndis.h)

另请参阅

WWAN 数据包上下文管理