IFhReassociation::ValidateTarget method (fhcfg.h)

Article
02/22/2024

This method checks whether a certain storage device or network share can be used as a File History default target and, thus, whether reassociation is possible at all or not.

Note

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

Syntax

HRESULT ValidateTarget(
  [in]  BSTR                         TargetUrl,
  [out] PFH_DEVICE_VALIDATION_RESULT ValidationResult
);

Parameters

[in] TargetUrl

Specifies the storage device or network share to be validated.

[out] ValidationResult

On return, contains a value specifying the result of the device validation. See the FH_DEVICE_VALIDATION_RESULT enumeration for a detailed description of supported device validation results.

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.

Remarks

For local disks, the TargetUrl parameter contains the drive letter. This path must end with a trailing backslash (for example, "X:\").

For network shares, the TargetUrl parameter contains the full path of the share. This path must end with a trailing backslash (for example, "\\myserver\myshare\").

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