InitPropVariantFromGUIDAsBuffer
TOC
Collapse the table of content
Expand the table of content

InitPropVariantFromGUIDAsBuffer function

Initializes a PROPVARIANT structure based on a GUID. The structure is initialized as VT_VECTOR | VT_UI1.

Syntax


HRESULT InitPropVariantFromGUIDAsBuffer(
  _In_  REFGUID     guid,
  _Out_ PROPVARIANT *ppropvar
);

Parameters

guid [in]

Type: REFGUID

Reference to the source GUID.

ppropvar [out]

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_VECTOR | VT_UI1 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 InitPropVariantFromGUIDAsBuffer.


PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromGUIDAsBuffer(FMTID_DocSummaryInformation, &propvar);

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

Requirements

Minimum supported client

Windows XP with SP2, Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 with SP1 [desktop apps only]

Redistributable

Windows Desktop Search (WDS) 3.0

Header

Propvarutil.h

See also

PropVariantToBuffer
InitPropVariantFromCLSID
InitPropVariantFromGUIDAsString
InitVariantFromGUIDAsBuffer

 

 

Show:
© 2016 Microsoft