IMbnConnectionContextEvents::OnSetProvisionedContextComplete メソッド (mbnapi.h)

  • [アーティクル]

重要

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

デバイスにプロビジョニングされたコンテキストが設定されていることを示すために、モバイル ブロードバンド サービスによって呼び出される通知メソッド。

構文

HRESULT OnSetProvisionedContextComplete(
  [in] IMbnConnectionContext *newInterface,
  [in] ULONG                 requestID,
  [in] HRESULT               status
);

パラメーター

[in] newInterface

コンテキストが設定されているデバイスを表す IMbnConnectionContext インターフェイス。

[in] requestID

コンテキストを設定する操作を識別するためにモバイル ブロードバンド サービスによって設定される要求 ID。

[in] status

操作の結果を示す状態コード。

呼び出し元のアプリケーションでは、次のいずれかの値が必要です。

値 意味
S_OK
 操作に成功しました。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 デバイスはこの操作をサポートしていません。
E_MBN_PIN_REQUIRED
 操作を完了するには PIN が必要です。
E_INVALIDARG
 要求で指定されたコンテキスト ID またはプロバイダー ID が無効です。
E_MBN_BAD_SIM
 デバイスに不適切な SIM があります。
HRESULT_FROM_WIN32(ERROR_WRITE_FAULT)
 SIM またはデバイス メモリの更新に失敗しました。

戻り値

このメソッドは 、S_OKを返す必要があります。

注釈

呼び出し元のアプリケーションは、 IMbnConnectionContext インターフェイスを newInterface に渡して、デバイス内のプロビジョニングされたコンテキストの更新された一覧を取得できます。 ただし、この操作は非同期であるため、アプリケーションは、このインターフェイスを使用してコンテキストを取得する前 に、OnProvisionedContextListChange 通知を待機する必要があります。

通知を受け取るアプリケーションが複数登録されている場合は、そのうちの 1 つだけがこの操作を開始できた場合でも、すべてのアプリケーションがこの通知を受け取ります。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー mbnapi.h

こちらもご覧ください

IMbnConnectionContextEvents