Skip to main content
IPropertyValueStatics::CreateString method

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

Syntax


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

Parameters

value [in]

Type: HSTRING

The string value to store.

propertyValue [out, retval]

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 codeDescription
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

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Header

Windows.Foundation.h

IDL

Windows.Foundation.idl

See also

IPropertyValue::GetString
IPropertyValueStatics