IFhReassociation::GetConfigurationDetails method (fhcfg.h)

This method enumerates File History configurations that were discovered on a storage device or network share by the IFhReassociation::ScanTargetForConfigurations method and returns additional information about each of the discovered configurations.

Note

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

Syntax

HRESULT GetConfigurationDetails(
  [in]  DWORD    Index,
  [out] BSTR     *UserName,
  [out] BSTR     *PcName,
  [out] FILETIME *BackupTime
);

Parameters

[in] Index

Zero-based index of a discovered configuration.

[out] UserName

On return, contains a pointer to a string allocated with SysAllocString containing the name of the user account under which the configuration was last backed up to.

[out] PcName

On return, contains a pointer to a string allocated with SysAllocString containing the name of the computer from which the configuration was last backed up.

[out] BackupTime

On return, contains the date and time when the configuration was last backed up.

Return value

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

If there is no File History configuration with the specified index, the HRESULT_FROM_WIN32(ERROR_NOT_FOUND) error code is returned.

Remarks

The caller is responsible for releasing the memory allocated for UserName and PcName by calling SysFreeString on each of them.

In order to perform reassociation, one of the configurations enumerated by this method must be selected using the IFhReassociation::SelectConfiguration method and then the IFhReassociation::PerformReassociation method needs to be called.

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::PerformReassociation

IFhReassociation::ScanTargetForConfigurations

IFhReassociation::SelectConfiguration