IFhConfigMgr::ChangeDefaultTargetRecommendation method (fhcfg.h)

Article
10/13/2021

Causes the currently assigned backup target to be recommended or not recommended to other members of the home group that the computer belongs to.

Note

IFhConfigMgr is deprecated and may be altered or unavailable in future releases.

Syntax

HRESULT ChangeDefaultTargetRecommendation(
  [in] BOOL Recommend
);

Parameters

[in] Recommend

If set to TRUE, the currently assigned backup target is recommended to other members of the home group. If set to FALSE and the currently assigned backup target is currently recommended to other members of the home group, this recommendation is withdrawn.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code such as one of the values defined in the FhErrors.h header file.

Remarks

When a backup target is recommended to other computers in the home group, users on those computers see that storage device in the list of available backup targets in the File History item in Control Panel.

If the backup target is not recommended to other computers in the home group, or if the recommendation is withdrawn, the target does not appear in the list of available backup targets on the other computers.

A backup target cannot be recommended or not recommended on a computer that is joined to a domain or on a computer that is having ARM architecture.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Target Platform	Windows
Header	fhcfg.h