InitPropVariantFromString function (propvarutil.h)
Initializes a PROPVARIANT structure based on a specified string.
HRESULT InitPropVariantFromString(
[in] PCWSTR psz,
[out] PROPVARIANT *ppropvar
);
[in] psz
Type: PCWSTR
Pointer to a buffer that contains the source Unicode string.
[out] ppropvar
Type: PROPVARIANT*
When this function returns, contains the initialized PROPVARIANT structure.
Type: HRESULT
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
This is an inline function, with its source code provided in the header. It is not included in any .dll or .lib file.
The following example, to be included as part of a larger program, demonstrates how to use InitPropVariantFromString.
PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromString(L"Hello World", &propvar);
if (SUCCEEDED(hr))
{
// propvar now is valid and has type VT_LPWSTR.
PropVariantClear(&propvar);
}
Requirement | Value |
---|---|
Minimum supported client | Windows XP with SP2, Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2003 with SP1 [desktop apps only] |
Target Platform | Windows |
Header | propvarutil.h |
Redistributable | Windows Desktop Search (WDS) 3.0 |
InitPropVariantFromStringAsVector