InitPropVariantFromInt16 function (propvarutil.h)

Initializes a PROPVARIANT structure based on a 16-bit integer value.

Syntax

HRESULT InitPropVariantFromInt16(
  [in]  SHORT       nVal,
  [out] PROPVARIANT *ppropvar
);

Parameters

[in] nVal

Type: SHORT

The source SHORT value.

[out] ppropvar

Type: PROPVARIANT*

When this function returns, contains the initialized PROPVARIANT structure.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This function creates a VT_I2 propvariant.

This is an inline function, with its source code provided in the header. It is not included in any .dll or .lib file.

Examples

The following example, to be included as part of a larger program, demonstrates how to use InitPropVariantFromInt16.

PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromInt16(42, &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_I2.
 
    PropVariantClear(&propvar);
}

Requirements

See also

InitPropVariantFromInt16Vector

InitVariantFromInt16

PropVariantToInt16

PropVariantToInt16WithDefault