IMbnInterface::SetPreferredProviders メソッド (mbnapi.h)

重要

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

デバイスの優先プロバイダーの一覧を更新します。

構文

HRESULT SetPreferredProviders(
  [in]  SAFEARRAY *preferredProviders,
  [out] ULONG     *requestID
);

パラメーター

[in] preferredProviders

優先プロバイダーの一覧を含む MBN_PROVIDER 構造体の配列。

[out] requestID

この要求のオペレーティング システムによって設定された要求 ID へのポインター。 非同期応答には、これと同じ requestID が含まれます。

戻り値

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

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

解説

SetPreferredProviders メソッドは、インターフェイスの優先プロバイダー リストの更新を開始します。 これは非同期操作であり、メソッド呼び出しはすぐに返されます。 このメソッドが (S_OKで) 正常に返された場合、オペレーティング システムは IMbnInterfaceEvents の OnSetPreferredProvidersComplete メソッドを呼び出すことによって、この操作の完了状態を呼び出し元のアプリケーションに通知します。

この操作が完了する前にデバイスがシステムから削除された場合、呼び出し元アプリケーションによって完了通知が受信される保証はありません。

要件

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

関連項目

IMbnInterface