MsiSourceListSetInfoA function (msi.h)

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

Syntax

UINT MsiSourceListSetInfoA(
  [in]           LPCSTR            szProductCodeOrPatchCode,
  [in, optional] LPCSTR            szUserSid,
  [in]           MSIINSTALLCONTEXT dwContext,
  [in]           DWORD             dwOptions,
  [in]           LPCSTR            szProperty,
  [in]           LPCSTR            szValue
);

Parameters

[in] szProductCodeOrPatchCode

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.

[in, optional] szUserSid

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.

[in] dwContext

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

[in] dwOptions

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.

[in] szProperty

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.

[in] szValue

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.

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.

Requirements

See also

Installation Context

MsiSourceListGetInfo

Not Supported in Windows Installer 2.0 and earlier

ProductCode