StgSerializePropVariant function

The StgSerializePropVariant function converts a PROPVARIANT data type to a SERIALIZEDPROPERTYVALUE data type.

Syntax

PSSTDAPI StgSerializePropVariant(
  const PROPVARIANT       *ppropvar,
  SERIALIZEDPROPERTYVALUE **ppProp,
  ULONG                   *pcb
);

Parameters

ppropvar

A pointer to PROPVARIANT.

ppProp

A pointer to the newly allocated SERIALIZEDPROPERTYVALUE.

pcb

A pointer to the size of the newly allocated SERIALIZEDPROPERTYVALUE.

Return Value

This function can return one of these values.

Remarks

The StgSerializePropVariant function serializes a PROPVARIANT. The function is similar to the StgConvertVariantToProperty function, but the StgSerializePropVariant function automatically handles memory allocation for the new SERIALIZEDPROPERTYVALUE. In addition, StgSerializePropVariant uses the default values CP_WINUNICODE and PID_ILLEGAL for code page and property ID respectively. Use StgSerializePropVariant unless control over these arguments is specifically needed.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header propvarutil.h
Library Propsys.lib
DLL Propsys.dll

See Also

StgConvertVariantToProperty

StgDeserializePropVariant