共用方式為

IMbnConnectionProfileManager：：CreateConnectionProfile 方法 (mbnapi.h)

  • 發行項

重要

從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。

建立裝置的新連線設定檔。

語法

HRESULT CreateConnectionProfile(
  [in] LPCWSTR xmlProfile
);

參數

[in] xmlProfile

以 Null 終止的字串，其中包含符合 行動寬頻設定檔架構參考之 XML 格式的設定檔資料。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
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 資料中指定了預設設定檔旗標，不過行動寬頻裝置的預設設定檔已經存在。

備註

這是同步作業。 如果此函式呼叫成功，則會建立新的設定檔，且行動寬頻服務會呼叫IMbnectionProfileManagerEvents介面的OnConnectionProfileArrival方法。

如果在設定檔資料中指定圖示檔案位置，行動寬頻服務會從自己的存放區中指定的位置複製圖示檔案。 圖示檔案位置 之 IMbnConnectionProfile 物件的後續查詢會傳回行動寬頻服務儲存圖示檔案的檔案位置。 每當從系統刪除設定檔時，也會從系統刪除其圖示檔案。 圖示檔案應採用 bmp 檔案格式檔案，且具有 32x32 圖元尺寸。

需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 mbnapi.h

另請參閱

IMbnConnectionProfileManager