通过

IMbnConnectionProfileManager：：CreateConnectionProfile 方法 (mbnapi.h)

  • 项目

重要

从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的Windows 运行时 API。

为设备创建新的连接配置文件。

语法

HRESULT CreateConnectionProfile(
  [in] LPCWSTR xmlProfile
);

parameters

[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 数据中指定了默认配置文件标志，但移动宽带设备已存在默认配置文件。

注解

这是一个同步操作。 如果此函数调用成功，则会创建新的配置文件，移动宽带服务将调用 IMbnConnectionProfileManagerEvents 接口的 OnConnectionProfileArrival 方法。

如果在配置文件数据中指定了图标文件位置，则移动宽带服务将从其自己的存储中的指定位置复制图标文件。 针对图标文件位置的 IMbnConnectionProfile 对象的后续查询将返回移动宽带服务存储图标文件的文件位置。 每当从系统中删除配置文件时，其图标文件也会从系统中删除。 图标文件应采用 bmp 文件格式，尺寸为 32x32 像素。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 mbnapi.h

另请参阅

IMbnConnectionProfileManager