MsiSummaryInfoSetProperty Function Home
MsiSummaryInfoSetProperty Function

The MsiSummaryInfoSetProperty function sets a single summary information property.

Note  The meaning of the property value depends on whether the summary information stream is for an installation database (.msi file), transform (.mst file) or patch (.msp file). See Summary Property Descriptions and Summary Information Stream Property Set for more information about summary information properties.

Syntax

UINT MsiSummaryInfoSetProperty(
  __in  MSIHANDLE hSummaryInfo,
  __in  UINT uiProperty,
  __in  UINT uiDataType,
  __in  INT iValue,
  __in  FILETIME *pftValue,
  __in  LPTSTR szValue
);


Parameters

hSummaryInfo [in]

Handle to summary information.

uiProperty [in]

Specifies the property ID of the summary property being set. This parameter can be a property ID listed in the Summary Information Stream Property Set. This function does not set values for PID_DICTIONARY OR PID_THUMBNAIL property.

uiDataType [in]

Specifies the type of property to set. This parameter can be a type listed in the Summary Information Stream Property Set.

iValue [in]

Specifies the integer value.

pftValue [in]

Specifies the file-time value.

szValue [in]

Specifies the text value.

Return Value

The MsiSummaryInfoSetProperty function returns the following 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.

Requirements

VersionWindows Installer 5.0 on Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003, Windows XP, and Windows 2000
HeaderMsiquery.h
LibraryMsi.lib
DLLMsi.dll
Unicode and ANSI namesMsiSummaryInfoSetPropertyW (Unicode) and MsiSummaryInfoSetPropertyA (ANSI)

See Also

Summary Information Property Functions
Summary Information Stream Property Set
Summaryinfo.Property

Send comments about this topic to Microsoft

Build date: 11/12/2009

Community Content

vb.net syntax
Added by:dmex
<DllImport("msi.dll", CharSet:=CharSet.Unicode)> _
Public Shared Function MsiSummaryInfoSetProperty(ByVal hSummaryInfo As Integer, ByVal uiProperty As UInt32, ByVal uiDataType As UInt32, ByVal iValue As Integer, ByRef ftValue As Long, ByVal szValue As String) As UInt32
End Function
C# syntax
Added by:dmex
[DllImport("msi.dll", CharSet=CharSet.Unicode)]
public static extern uint MsiSummaryInfoSetProperty(int hSummaryInfo, uint uiProperty, uint uiDataType, int iValue, ref long ftValue, string szValue);
© 2009 Microsoft Corporation. All rights reserved.   Terms of Use | Trademarks | Privacy Statement
Page view tracker
Rate the Lightweight library
x
Lightweight builds on ScriptFree (loband) by adding features you've requested: a SearchBox and default code language selection.
Do you like the SearchBox?
Do you like the tabbed code blocks?
How useful is this topic?
Tell us more.
Thanks
x
You're helping to improve MSDN Online.
Feedback
Switch View
Classic
Lightweight Beta
ScriptFree
Switch View