共用方式為

IMbnServiceActivationEvents：：OnActivationComplete 方法 (mbnapi.h)

  • 發行項

重要

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

行動寬頻服務所呼叫的通知方法，表示服務啟用要求 ahs 已完成。

語法

HRESULT OnActivationComplete(
  [in] IMbnServiceActivation *serviceActivation,
  [in] SAFEARRAY             *vendorSpecificData,
  [in] ULONG                 requestID,
  [in] HRESULT               status,
  [in] ULONG                 networkError
);

參數

[in] serviceActivation

IMbnServiceActivation 介面的指標，代表執行要求所在的裝置。

[in] vendorSpecificData

位元組陣列，包含基礎行動寬頻迷你埠 驅動程式NDIS_STATUS_WWAN_SERVICE_ACTIVATION所傳回的數據。

[in] requestID

初始化要求時，行動寬頻服務所指派的要求標識符。

[in] status

完成狀態。

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

值 意義
S_OK
 作業成功。
E_INVALIDARG
 迷你埠驅動程序偵測到要求中的輸入數據不正確。
E_MBN_PIN_REQUIRED
 作業需要 PIN 才能完成。
E_MBN_RADIO_POWER_OFF
 行動寬頻裝置未啟動電源。
E_MBN_PROVIDER_NOT_VISIBLE
 服務提供者看不到。
E_MBN_SIM_NOT_INSERTED
 裝置中沒有 SIM 卡。
E_MBN_BAD_SIM
 裝置中有不正確的 SIM 卡。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
裝置不支援這項作業。

[in] networkError

啟用作業期間網路傳回的錯誤碼。 只有當 狀態 不是S_OK時，這個值才有意義。

networkError 的確切值與驅動程式/網路相依。

傳回值

這個方法必須傳回 S_OK。

備註

成功的服務啟用也會導致變更裝置的就緒狀態。 行動寬頻服務會將 IMbnInterfaceEvents 的 OnReadyStateChange 方法呼叫為通知。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 mbnapi.h

另請參閱

IMbnServiceActivationEvents