WWAN_REGISTRATION_STATE結構（wwan.h）
WWAN_REGISTRATION_STATE 結構代表 MB 裝置的註冊狀態。
語法
typedef struct _WWAN_REGISTRATION_STATE {
ULONG uNwError;
WWAN_REGISTER_STATE RegisterState;
WWAN_REGISTER_MODE RegisterMode;
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
WCHAR RoamingText[WWAN_ROAMTEXT_LEN];
DWORD WwanRegFlags;
WWAN_CELLULAR_CLASS CurrentCellularClass;
ULONG PreferredDataClasses;
} WWAN_REGISTRATION_STATE, *PWWAN_REGISTRATION_STATE;
成員
uNwError
發生註冊失敗時的網路特定錯誤。 如需此成員的詳細資訊，請參閱下列一節。
RegisterState
裝置的註冊狀態。 如需已定義值的清單，請參閱 WWAN_REGISTER_STATE。
WwanRegisterStatePartner 值表示裝置是在慣用的合作夥伴網路提供者上漫遊，而 WwanRegisterStateRoaming 值表示裝置只是漫遊。 如果無法使用漫遊狀態的合作夥伴特徵，迷你埠驅動程式應回報 WwanRegisterStateRoaming。
RegisterMode
裝置的註冊模式。 如需已定義值的清單，請參閱 WWAN_REGISTER_MODE。
ProviderId[WWAN_PROVIDERID_LEN]
代表網路提供者身分識別的NULL終止數值 （0-9） 字串。
針對 GSM 型網路，此字串是三位數行動國家 /地區代碼 （MCC） 和兩或三位數行動網路代碼 （MNC） 的串連。 GSM 型電信業者可能有多個 MNC，因此 ProviderId 多個。
針對 CDMA 型網路，此字串是五位數的系統識別碼（SID）。 一般而言，CDMA 型電信業者有多個 SID。 一般而言，一家航空公司針對每個市場都有一個 SID，通常根據美國大都市統計區（MSA）等法規，在一個國家內以地理上劃分。 CDMA 型裝置的迷你埠驅動程式必須在無法使用此資訊時指定WWAN_CDMA_DEFAULT_PROVIDER_ID。
處理 查詢 要求，且註冊狀態處於自動註冊模式時，這個成員會包含裝置目前相關聯的提供者標識元（如果適用的話）。 當註冊狀態處於手動註冊模式時，此成員會包含要求裝置向註冊的提供者標識碼（即使提供者無法使用）。
處理 集 要求，且註冊狀態處於手動模式時，這包括由 MB 服務為裝置註冊的提供者標識符。 當註冊狀態處於自動註冊模式時，會忽略此參數。
如果提供者標識碼無法使用，CDMA 1xRTT 提供者必須設定為 WWAN_CDMA_DEFAULT_PROVIDER_ID。
ProviderName[WWAN_PROVIDERNAME_LEN]
NULL 終止的字串，表示網路提供者的名稱。 此成員最多只能WWAN_PROVIDERNAME_LEN個字元。
針對 GSM 型網路，如果偏好呈現國家 /地區縮寫和行動網路名稱 （PPCI&N） 超過 20 個字元，則迷你埠驅動程式應縮寫網路名稱。
當 MB 服務設定慣用的提供者清單時，會忽略此成員。
迷你埠驅動程式應該為沒有這項資訊的裝置指定 NULL 字串。
RoamingText[WWAN_ROAMTEXT_LEN]
以 NULL 終止的字串，通知使用者裝置正在漫遊。 此成員最多只能有WWAN_ROAMTEXT_LEN個字元。
當註冊狀態為 WwanRegisterStatePartner 或 WwanRegisterStateRoaming時，此文字應為使用者提供其他資訊。 這個成員是選擇性的。
WwanRegFlags
註冊旗標。
| 價值 | 意義 |
|---|---|
| WWAN_REG_FLAGS_NONE | 沒有註冊旗標。 |
| WWAN_REG_FLAGS_NO_MANUAL_REG | 沒有手動附加。 |
| WWAN_REG_FLAGS_PS_AUTO_ATTACH | 表示 MB 裝置會管理自己的封包內容。 MB 服務不會將封包中斷鏈接傳送至迷你埠驅動程式，但可能會傳送封包連結。 |
CurrentCellularClass
已註冊網路的目前行動數據類別。 針對僅支援單一行動數據類別的網路，此成員應該設定為該行動數據類別。 針對支援多重模式的網路，迷你埠驅動程式會在網路變更其行動數據類別時，將NDIS_STATUS_WWAN_REGISTER_STATE通知傳送至 MB 服務。
PreferredDataClasses
位掩碼，表示聯機慣用的數據存取技術。
言論
查詢 和 設定 OID 要求，以及未經請求的狀態事件會使用 uNwError 成員。 如果沒有網路特定錯誤或網路特定錯誤未知，迷你埠驅動程序應該將此成員設定為零。 MB作語意中的「狀態指示結構」區段 會顯示 3GPP TS 24.008 規格中定義的註冊原因代碼失敗值。
下列幾點提供在不同案例中傳回網路特定錯誤的指導方針：
- 如果網路註冊因為網路特定錯誤而失敗，迷你埠驅動程序應該傳回網路特定錯誤，以回應 查詢 要求。 在此情況下，迷你埠驅動程式應將 NDIS_WWAN_REGISTRATION_STATE 結構的 uStatus 成員設定為 WWAN_STATUS_SUCCESS，並將 uNwError 成員設定為網路特定錯誤碼。
- 如果 要求失敗，迷你埠驅動程式應該會傳回網路特定的錯誤碼。 在此情況下，迷你埠驅動程式應將 uStatus NDIS_WWAN_REGISTRATION_STATE 結構的成員設定為 WWAN_STATUS_FAILURE，並將 uNwError 成員設定為網路特定錯誤碼。
- 每當裝置註冊狀態因為網路取消註冊裝置而變更時（例如，網路因為裝置的訂用帳戶過期而取消註冊裝置），則未經請求的狀態事件應該包含網路特定錯誤。 在此情況下，迷你埠驅動程式應將 NDIS_WWAN_REGISTRATION_STATE 結構的 uStatus 成員設定為 WWAN_STATUS_SUCCESS，並將 uNwError 成員設定為網路特定錯誤碼。
迷你埠驅動程式可以提供其他錯誤碼，如網路所傳回封包附加錯誤碼的 GSM 標準規格所定義。 例如，迷你埠驅動程式可以透過 uNwError 成員，將 3GPP 規格 TS 24.008 封包附加錯誤碼，例如錯誤碼 12（不允許位置區域）與 MB 服務通訊。
迷你埠驅動程序必須儘早回報原因代碼。 例如，如果 MB 裝置在嘗試向網路提供者註冊裝置時遇到下列其中一個程式代碼，迷你埠驅動程式應該在該時間回報它。
線上到多模式網路的迷你埠驅動程式應該透過 NDIS_STATUS_WWAN_REGISTER_STATE 通知來指出行動數據類別變更。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 8 和更新版本的 Windows。 |
| 標頭 | wwan.h （包括 Wwan.h） |