The MsiSourceListSetInfo function sets information about the source list for a product or patch in a specific context.

Syntax

C++UINT MsiSourceListSetInfo(
  __in      LPCTSTR szProductCodeOrPatchCode,
  __in_opt  LPCTSTR szUserSid,
  __in      MSIINSTALLCONTEXT dwContext,
  __in      DWORD dwOptions,
  __in      LPCTSTR szProperty,
  __in      LPCTSTR szValue
);

Parameters

szProductCodeOrPatchCode [in]

The ProductCode or patch GUID of the product or patch. Use a null-terminated string. If the string is longer than 39 characters, the function fails and returns ERROR_INVALID_PARAMETER. This parameter cannot be NULL.

szUserSid [in, optional]

This parameter can be a string SID that specifies the user account that contains the product or patch. The SID is not validated or resolved. An incorrect SID can return ERROR_UNKNOWN_PRODUCT or ERROR_UNKNOWN_PATCH. When referencing a machine context, szUserSID must be NULL and dwContext must be MSIINSTALLCONTEXT_MACHINE.

Type of SID	Meaning
NULL	NULL denotes the currently logged on user. When referencing the current user account, szUserSID can be NULL and dwContext can be MSIINSTALLCONTEXT_USERMANAGED or MSIINSTALLCONTEXT_USERUNMANAGED.
User SID	Specifies enumeration for a particular user in the system. An example of a user SID is "S-1-3-64-2415071341-1358098788-3127455600-2561".

 

Note  The special SID string s-1-5-18 (system) cannot be used to enumerate products or patches installed as per-machine. Setting the SID value to s-1-5-18 returns ERROR_INVALID_PARAMETER.

Note  The special SID string s-1-1-0 (everyone) should not be used. Setting the SID value to s-1-1-0 fails and returns ERROR_INVALID_PARAM.

dwContext [in]

This parameter specifies the context of the product or patch instance. This parameter can contain one of the following values.

Type of context	Meaning
MSIINSTALLCONTEXT_USERMANAGED	The product or patch instance exists in the per-user-managed context.
MSIINSTALLCONTEXT_USERUNMANAGED	The product or patch instance exists in the per-user-unmanaged context.
MSIINSTALLCONTEXT_MACHINE	The product or patch instance exists in the per-machine context.

 

dwOptions [in]

The dwOptions value specifies the meaning of szProductCodeOrPatchCode.

If the property being set is "LastUsedSource", this parameter also specifies the type of source as network or URL. In this case, the dwOptions parameter must be a combination of one of the following MSISOURCETYPE_* constants and one of the following MSICODE_* constants.

Flag	Meaning
MSISOURCETYPE_NETWORK	The source is a network type.
MSISOURCETYPE_URL	The source is a URL type.
MSICODE_PRODUCT	szProductCodeOrPatchCode is a product code GUID.
MSICODE_PATCH	szProductCodeOrPatchCode is a patch code GUID.

 

szProperty [in]

The parameter szProperty indicates the property value to set. Not all properties that can be retrieved through MsiSourceListGetInfo can be set via a call to MsiSourceListSetInfo. The szProperty value can be one of the following values.

Name	Meaning
INSTALLPROPERTY_MEDIAPACKAGEPATH "MediaPackagePath"	The path relative to the root of the installation media.
INSTALLPROPERTY_DISKPROMPT "DiskPrompt"	The prompt template used when prompting the user for installation media.
INSTALLPROPERTY_LASTUSEDSOURCE "LastUsedSource"	The most recently used source location for the product. If the source is not registered, the function calls MsiSourceListAddSourceEx to register it. On successful registration, the function sets the source as the LastUsedSource.
INSTALLPROPERTY_PACKAGENAME "PackageName"	The name of the Windows Installer package or patch package on the source.

 

szValue [in]

The new value of the property. No validation of the new value is performed. This value cannot be NULL. It can be an empty string.

Return Value

The MsiSourceListSetInfo function returns the following values.

Value	Meaning
ERROR_ACCESS_DENIED	The user does not have the ability to set the source list for the specified product.
ERROR_BAD_CONFIGURATION	The configuration data is corrupt.
ERROR_INSTALL_SERVICE_FAILURE	The Windows Installer service could not be accessed.
ERROR_INVALID_PARAMETER	An invalid parameter was passed to the function.
ERROR_SUCCESS	The property was set.
ERROR_UNKNOWN_PATCH	The patch was not found.
ERROR_UNKNOWN_PRODUCT	The product was not found.
ERROR_UNKNOWN_PROPERTY	The source property was not found.
ERROR_FUNCTION_FAILED	Unexpected internal failure.

 

Remarks

Administrators can modify the installation of a product or patch instance that exists under the machine context or under their own per-user context (managed or unmanaged.) They can modify the installation of a product or patch instance that exists under any user's per-user-managed context. Administrators cannot modify another user's installation of a product or patch instance that exists under that other user's per-user-unmanaged context.

Non-administrators cannot modify the installation of a product or patch instance that exists under another user's per-user context (managed or unmanaged.) They can modify the installation of a product or patch instance that exists under their own per-user-unmanaged context. They can modify the installation of a product or patch instance under the machine context or their own per-user-managed context only if they are enabled to browse for a product or patch source. Users can be enabled to browse for sources by setting policy. For more information, see the DisableBrowse, AllowLockdownBrowse, and AlwaysInstallElevated policies.

An exception to the above rule is setting "LastUsedSource" to one of the registered sources. If the source is already registered, a non-administrator can set "LastUsedSource" to their own installations (managed or non-managed) and per-machine installations, irrespective of policies.

Windows Installer 2.0:  Not supported. The MsiSourceListSetInfo function is available beginning with Windows Installer 3.0.

Requirements

Version	Windows 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 3.0 or later on Windows Server 2003, Windows XP, and Windows 2000. See the Windows Installer Run-Time Requirements for information about the minimum Windows service pack that is required by a Windows Installer version.
Header	Msi.h
Library	Msi.lib
DLL	Msi.dll
Unicode and ANSI names	MsiSourceListSetInfoW (Unicode) and MsiSourceListSetInfoA (ANSI)

See Also

ProductCode

Installation Context

MsiSourceListGetInfo

Send comments about this topic to Microsoft

Build date: 8/13/2009