IPropertyValueStatics::CreateString method (windows.foundation.h)

Creates a new IPropertyValue object that contains the specified string value.

Syntax

HRESULT CreateString(
  [in]          HSTRING      value,
  [out, retval] IInspectable **propertyValue
);

Parameters

[in] value

Type: HSTRING

The string value to store.

[out, retval] propertyValue

Type: IInspectable**

A pointer to a new object that contains value. Use the IUnknown::QueryInterface method to get the IPropertyValue interface for the object.

Return value

Type: HRESULT

This method can return one of these values.

Return code Description
S_OK
The property value was created successfully.
E_POINTER
value is NULL.
E_OUTOFMEMORY
The IPropertyValue object could not be created.

Remarks

Use the CreateString method to store a value in an IPropertyValue object. You can add the IPropertyValue object to a property store. Use the GetString method to retrieve the value from the IPropertyValue object.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Windows
Header windows.foundation.h

See also

IPropertyValue::GetString

IPropertyValueStatics