InitPropVariantFromUInt64 function (propvarutil.h)

Initializes a PROPVARIANT structure with a 64-bit unsigned integer value.

Syntax

HRESULT InitPropVariantFromUInt64(
  [in]  ULONGLONG   ullVal,
  [out] PROPVARIANT *ppropvar
);

Parameters

[in] ullVal

Type: ULONGLONG

Source ULONGLONG 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

Creates a VT_UI8 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 InitPropVariantFromUInt64.

PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromUInt64(563, &propvar);

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

Requirements

See also

InitVariantFromUInt64

PropVariantToUInt64

PropVariantToUInt64WithDefault