MsiSummaryInfoSetProperty

[This is preliminary documentation and subject to change.]

The MsiSummaryInfoSetProperty function sets a single summary information property.

UINT MsiSummaryInfoSetProperty(
  MSIHANDLE hSummaryInfo, // summary information handle
  UINT uiProperty,        // property ID, one of allowed values
                          // for summary information
  UINT uiDataType,        // VT_I4, VT_LPTSTR, VT_FILETIME,
                          // or VT_EMPTY
  INT iValue,             // integer value, used only if integer
                          // property
  FILETIME *pftValue,     // pointer to file-time value, used only
                          // if date/time property
  LPCTSTR szValue         // text value, used only if string property
);
 

Parameters

hSummaryInfo

Handle to summary information.

uiProperty

Specifies the property to set.

uiDataType

Specifies the type of property to set.

iValue

Specifies the integer value.

pftValue

Specifies the file-time value.

szValue

Specifies the text value.

Return Values

ERROR_DATATYPE_MISMATCH

The data types were mismatched.

ERROR_FUNCTION_FAILED

The function failed.

ERROR_INVALID_HANDLE

An invalid or inactive handle was supplied.

ERROR_INVALID_PARAMETER

An invalid parameter was passed to the function.

ERROR_SUCCESS

The function succeeded.

ERROR_UNKNOWN_PROPERTY

The summary information property is unknown.

ERROR_UNSUPPORTED_TYPE

The type is unsupported.

QuickInfo

  Windows NT: Requires version 4.0 or later. Available as a redistributable for Windows NT 4.0.
  Windows: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in msiquery.h.
  Import Library: Use msi.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Database Access Reference, Summary Information Property Functions