添加

将配置文件添加到集合中。

语法

HRESULT Add
  ([in] IProfile* pProfile,
  [in] VARIANT_BOOL fMerge)
;

参数

pProfile
[in] 指向要添加到集合中的 IProfile 对象的指针。

fMerge
[in] 一个布尔值,指示是否将 pProfile 与集合中的同名配置文件合并。 如果集合中具有可变配置文件,并且此参数设置为 TRUE,则合并配置文件。 否则,该方法将返回错误。 如果集合中没有同名的配置文件,该方法将忽略此参数,并向集合添加配置文件。

返回值

下表描述了可能的返回值。

返回值 说明

S_OK

函数已成功向集合添加了配置文件。

E_INVALIDARG

一个或多个参数无效。 使用 IErrorInfo 获取详细的错误信息。

E_WPRC_FAILED_TO_ADD_PROFILE

库未能向集合添加配置文件。 使用 IErrorInfo 获取详细的错误信息。

IProfileCollection