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 網路中，這會是 APN) 例如 「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