IFhTarget::GetStringProperty method (fhcfg.h)

Retrieves a string property of the File History backup target that is represented by an IFhTarget interface.


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


HRESULT GetStringProperty(
  [in]  FH_TARGET_PROPERTY_TYPE PropertyType,
  [out] BSTR                    *PropertyValue


[in] PropertyType

Specifies the string property. See the FH_TARGET_PROPERTY_TYPE enumeration for the list of possible string property types.

[out] PropertyValue

This parameter must be NULL on input. On output, it receives a pointer to a string that contains the string property. This string is allocated by calling SysAllocString. You must call SysFreeString to free the string when it is no longer needed.

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.


The FH_TARGET_PROPERTY_TYPE enumeration defines property types for string properties and numeric properties. However, the IFhTarget::GetStringProperty method can only be used to retrieve string properties. Numeric properties must be retrieved by calling the IFhTarget::GetNumericalProperty method.


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