IMbnServiceActivationEvents::OnActivationComplete メソッド (mbnapi.h)

  • [アーティクル]

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows ランタイム API に置き換えられます。

モバイル ブロードバンド サービスによって呼び出され、サービスのアクティブ化要求が完了したことを示す通知メソッド。

構文

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

要求の初期化時にモバイル ブロードバンド サービスによって割り当てられた要求 ID。

[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