IMbnConnectionEvents：：OnConnectComplete 方法 (mbnapi.h)

重要

從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。

通知方法，表示連線作業完成。

語法

HRESULT OnConnectComplete(
  [in] IMbnConnection *newConnection,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

[in] newConnection

IMbnConnection介面，表示連線作業已完成的裝置。

[in] requestID

行動寬頻服務指派的要求識別碼，以識別連線作業。

[in] status

完成狀態。

呼叫的應用程式可以預期下列其中一個值。

值	意義
S_OK	作業成功。
E_MBN_SIM_NOT_INSERTED	裝置中沒有 SIM 卡。
E_MBN_PIN_REQUIRED	作業需要 PIN 才能完成。
E_MBN_SERVICE_NOT_ACTI加值稅ED	網路服務訂用帳戶已過期。
E_MBN_PROVIDER_NOT_VISIBLE	提供者看不到。這僅適用于手動註冊模式。
E_MBN_INVALID_ACCESS_STRING	連接字串不正確。
HRESULT_FROM_WIN32 (ERROR_INVALID_PASSWORD)	連線設定檔中使用的名稱或密碼不正確。
E_MBN_VOICE_CALL_IN_PROGRESS	作用中的語音通話正在進行中。
E_MBN_MAX_ACTI加值稅ED_CONTEXTS	行動寬頻內容已作用中。行動寬頻服務目前不支援多個作用中內容。
E_MBN_RADIO_POWER_OFF	裝置無線電已關閉。
E_MBN_PACKET_SVC_DETACHED	沒有作用中的附加封包服務可用。
E_MBN_ACTIVE_CONNECTION	裝置已連線到網路。

這個方法必須傳回 S_OK。

建立啟用內容之後，應用程式可以使用 IMbnConnection 來取得目前的線上狀態。

當連線作業產生錯誤時，應用程式可以呼叫IMbnConnection介面的GetActivationNetworkError方法，以取得網路錯誤資訊。