IFhConfigMgr::P rovisionAndSetNewTarget 方法 (fhcfg.h)

将特定存储设备或网络共享预配为文件历史记录备份目标,并将其分配为当前用户的默认备份目标。

注意

IFhConfigMgr 已弃用,将来的版本中可能会更改或不可用。

语法

HRESULT ProvisionAndSetNewTarget(
  [in] BSTR TargetUrl,
  [in] BSTR TargetName
);

参数

[in] TargetUrl

指定要预配并分配为默认值的存储设备或网络共享。

[in] TargetName

指定指定备份目标的用户友好名称。

返回值

如果该方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码,例如 FhErrors.h 头文件中定义的值之一。

备注

对于本地磁盘, TargetUrl 参数包含驱动器号。 此路径必须以尾部反斜杠 (结尾,例如“X:\”) 。

对于网络共享, TargetUrl 参数包含共享的完整路径。 此路径必须以尾部反斜杠 (结尾,例如“\\myserver\myshare\”) 。

强烈建议先使用 IFhConfigMgr::ValidateTarget 方法验证 TargetUrl 参数指定的存储设备或网络共享。 如果 ValidateTarget 返回 FH_VALID_TARGET以外的验证结果,则将此存储设备或网络共享分配为默认备份目标可能会产生不可预知的后果。

要求

   
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 fhcfg.h

请参阅

FhConfigMgr

IFhConfigMgr

IFhConfigMgr::ValidateTarget