MBN_CONTEXT 结构 (mbnapi.h)

重要

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

MBN_CONTEXT结构存储有关连接上下文的信息。

语法

typedef struct MBN_CONTEXT {
  ULONG             contextID;
  MBN_CONTEXT_TYPE  contextType;
  BSTR              accessString;
  BSTR              userName;
  BSTR              password;
  MBN_COMPRESSION   compression;
  MBN_AUTH_PROTOCOL authType;
} MBN_CONTEXT;

成员

contextID

包含此上下文的唯一标识符。 这表示设备或 SIM 内存中的上下文索引。 如果设置为 MBN_CONTEXT_ID_APPEND，则设备将找到适当的索引来存储上下文。

contextType

指定上下文类型的 MBN_CONTEXT_TYPE 值。 应用程序可以使用此成员通过 IMbnConnectionContext 的 SetProvisionedContext 方法修改存储在特定索引处的上下文。

accessString

包含特定于连接的访问信息。 在 GSM 网络中，这将是接入点名称 (接入点) ，例如“data.thephone-company.com”。 在 CDMA 网络中，这可能是特殊的拨号代码（例如“#777”）或 NAI (网络访问标识符) ，例如“”。somebody@thephone-company.com

此字符串不得超过 MBN_ACCESSSTRING_LEN 个字符。 有关 MBN_ACCESSTRING_LEN的定义，请参阅 MBN_CONTEXT_CONSTANTS。 此字符串可以为空。 调用应用程序必须通过调用 SysFreeString 释放此字符串。

userName

包含用于身份验证的用户名。

字符串不得超过 MBN_USERNAME_LEN 个字符。 调用应用程序必须通过调用 SysFreeString 释放此字符串。 有关 MBN_USERNAME_LEN的定义，请参阅 MBN_CONTEXT_CONSTANTS。 调用应用程序必须通过调用 SysFreeString 释放此字符串。

password

包含用于身份验证的密码。

字符串不得超过 MBN_PASSWORD_LEN 个字符。 此字符串可以为空。 有关 MBN_PASSWORD_LEN的定义，请参阅 MBN_CONTEXT_CONSTANTS。 调用应用程序必须通过调用 SysFreeString 释放此字符串。

compression

一个 MBN_COMPRESSION 值，该值指定是否在标头和数据的数据链接中使用压缩。

此成员仅适用于 GSM 设备。

authType

一个 MBN_AUTH_PROTOCOL 值，该值指示用于 PDP (数据包数据协议) 激活的压缩类型。

此成员仅适用于 GSM 设备。 对于 CDMA 设备，它设置为 MBN_AUTH_PROTOCOL_NONE。

要求

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