IMbnConnectionContext::SetProvisionedContext メソッド (mbnapi.h)

  • [アーティクル]

重要

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

プロビジョニングされたコンテキストを追加または更新します。

構文

HRESULT SetProvisionedContext(
  [in]  MBN_CONTEXT provisionedContexts,
  [in]  LPCWSTR     providerID,
  [out] ULONG       *requestID
);

パラメーター

[in] provisionedContexts

デバイスまたは SIM に格納するプロビジョニング済みコンテキストを指定するMBN_CONTEXT構造体。

[in] providerID

プロビジョニングされたコンテキストを格納するネットワーク プロバイダー ID を表す文字列。 このホーム プロバイダー ID を持つ SIM がデバイスにある場合、デバイスは後続のクエリに応答して、追加されたプロビジョニングされたコンテキストを返す必要があります。

[out] requestID

この非同期要求を識別するためにモバイル ブロードバンド サービスによって設定された要求 ID。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_HANDLE
 インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスはシステムから削除されています。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスはシステムから削除されています。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 モバイル ブロードバンド サービスがこのシステムで実行されていません。
E_INVALID_ARG
 providerID が無効です。

注釈

provisionedContexts の contextID は、コンテキストが格納されるデバイスまたは SIM メモリ内のインデックスを指定します。 MBN_CONTEXT_ID_APPENDに設定されている場合、デバイスはコンテキストを格納するための適切なインデックスを見つける必要があります。

これは非同期操作であり、 SetProvisionedContext はすぐに返されます。 操作が完了すると、モバイル ブロードバンド サービスは IMbnConnectionContextEvents の OnSetProvisionedContextComplete メソッドを呼び出してアプリケーションに通知します。

現在のホーム プロバイダー ID のプロビジョニング済みコンテキスト リストへの追加は、IMbnConnectionContextEvents の OnProvisionedContextListChange メソッドが呼び出されるまで、クエリに使用できません。

要件

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

こちらもご覧ください

IMbnConnectionContext