次の方法で共有

IMbnConnectionProfileManager::CreateConnectionProfile メソッド (mbnapi.h)

  • [アーティクル]

重要

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

デバイスの新しい接続プロファイルを作成します。

構文

HRESULT CreateConnectionProfile(
  [in] LPCWSTR xmlProfile
);

パラメーター

[in] xmlProfile

モバイル ブロードバンド プロファイル スキーマ リファレンスに準拠した XML 形式のプロファイル データを含む null で終わる文字列。

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
 指定された名前のプロファイルは既に存在します。
E_MBN_INVALID_PROFILE
 プロファイルがモバイル ブロードバンド プロファイル スキーマに準拠していません。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
 プロファイルで渡されたアイコン ファイルの場所が無効であるか、アクセスできません。
E_MBN_DEFAULT_PROFILE_EXIST
 呼び出し元のアプリケーションで XML データに既定のプロファイル フラグが指定されましたが、モバイル ブロードバンド デバイスには既定のプロファイルが既に存在します。

解説

これは同期操作です。 この関数呼び出しが成功すると、新しいプロファイルが作成され、モバイル ブロードバンド サービスは IMbnConnectionProfileManagerEvents インターフェイスの OnConnectionProfileArrival メソッドを呼び出します。

プロファイル データでアイコン ファイルの場所が指定されている場合、モバイル ブロードバンド サービスは、独自のストア内の指定された場所からアイコン ファイルをコピーします。 アイコン ファイルの場所に対する IMbnConnectionProfile オブジェクトに対する後続のクエリは、モバイル ブロードバンド サービスがアイコン ファイルを格納したファイルの場所を返します。 プロファイルがシステムから削除されるたびに、そのアイコン ファイルもシステムから削除されます。 アイコン ファイルは、32 x 32 ピクセルのサイズの bmp ファイル形式のファイルである必要があります。

要件

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

関連項目

IMbnConnectionProfileManager