IMbnConnectionProfile：：UpdateProfile 方法 (mbnapi.h)

重要

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

更新設定檔的內容。

語法

HRESULT UpdateProfile(
  [in] LPCWSTR strProfile
);

[in] strProfile

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

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

傳回碼	描述
S_OK	已成功完成命令。
E_HANDLE	設定檔無效，而且可能已從系統中移除。
HRESULT_FROM_WIN32 (錯誤_NOT_FOUND)	設定檔無效，而且可能已從系統中移除。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)	設定檔資料會指定在指定位置找不到的圖示檔案。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	行動寬頻服務未在此系統上執行。

此方法所提供的資料符合行動寬頻設定檔架構參考。

當設定檔的裝置存在於系統中時，應該呼叫這個方法。

這是同步作業。如果成功，行動寬頻服務會呼叫IMbnConnectionProfileEvents介面的OnProfileUpdate方法來通知呼叫應用程式。