IFhConfigMgr::ValidateTarget method (fhcfg.h)

Article
02/22/2024

Checks whether a certain storage device or network share can be used as a File History backup target.

Note

IFhConfigMgr 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

The storage device or network share to be validated.

[out] ValidationResult

Receives the result of the device validation. See the FH_DEVICE_VALIDATION_RESULT enumeration for the list of possible device validation result values.

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

Share via