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 方法通知调用应用程序。