The MsiSourceListAddSource function adds to the list of valid network sources that contain the specified type of sources for a product or patch in a specified user context.

The number of sources in the SOURCELIST property is unlimited.

Syntax

C++UINT MsiSourceListAddSource(
  __in  LPCTSTR szProduct,
  __in  LPCTSTR szUserName,
  __in  DWORD dwReserved,
  __in  LPCTSTR szSource
);

Parameters

szProduct [in]

The ProductCode of the product to modify.

szUserName [in]

The user name for a per-user installation. On Windows 2000 or Windows XP, the user name should always be in the format of DOMAIN\USERNAME (or MACHINENAME\USERNAME for a local user).

An empty string or null for a per-machine installation.

dwReserved [in]

Reserved for future use. This value must be set to 0.

szSource [in]

Pointer to the string specifying the source.

Return Value

Remarks

An administrator can modify per-machine installations, their own per-user non-managed installations, and the per-user managed installations for any user. A non-administrator can only modify per-machine installations and their own (managed or non-managed)per-user installations. Users can be enabled to browse for sources by setting policy. For more information, see the DisableBrowse, AllowLockdownBrowse, and AlwaysInstallElevated policies.

Note that this function merely adds the new source to the list of valid sources. If another source was used to install the product, the new source is not used until the current source is unavailable.

It is the responsibility of the caller to ensure that the provided source is a valid source image for the product.

If the user name is an empty string or NULL, the function operates on the per-machine installation of the product. In this case, if the product is installed only in the per-user state, the function returns ERROR_UNKNOWN_PRODUCT.

If the user name is not an empty string or NULL, it specifies the name of the user whose product installation is modified. If the user name is the current user name, the function first attempts to modify a non-managed installation of the product. If no non-managed installation of the product can be found, the function then tries to modify a managed per-user installation of the product. If no managed or unmanaged per-user installations of the product can be found, the function returns ERROR_UNKNOWN_PRODUCT, even if the product is installed per-machine.

This function can not modify a non-managed installation for any user besides the current user. If the user name is not an empty string or NULL, but is not the current user, the function only checks for a managed per-user installation of the product for the specified user. If the product is not installed as managed per-user for the specified user, the function returns ERROR_UNKNOWN_PRODUCT, even if the product is installed per-machine.

Requirements

See Also

AllowLockdownBrowse

AlwaysInstallElevated

DisableBrowse

Source Resiliency

Installation Context

ProductCode

SOURCELIST

LookupAccountName

Send comments about this topic to Microsoft

Build date: 8/13/2009