IFhReassociation::PerformReassociation method (fhcfg.h)

This method re-establishes relationship between the current user and the configuration selected previously via the IFhReassociation::SelectConfiguration method and prepares the target device for accepting backup data from the current computer.

Note

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

Syntax

HRESULT PerformReassociation(
  [in] BOOL OverwriteIfExists
);

Parameters

[in] OverwriteIfExists

This parameter specifies how to handle the current File History configuration, if it already exists.

If this parameter is set to FALSE and File History is already configured for the current user, this method fails with the FHCFG_E_CONFIG_ALREADY_EXISTS error code and backups continue to be performed to the already configured target device.

If this parameter is set to TRUE and File History is already configured for the current user, the current configuration is replaced with the selected one and future backups after performed to the target device containing the selected configuration.

Return value

S_OK on success, or an unsuccessful HRESULT value on failure. Possible unsuccessful HRESULT values include values defined in the FhErrors.h header file.

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

See also

FhReassociation

IFhReassociation

IFhReassociation::SelectConfiguration