Función MsiSourceListAddSourceW (msi.h)

Artículo
08/24/2023

La función MsiSourceListAddSource agrega a la lista de orígenes de red válidos que contienen el tipo de orígenes especificado para un producto o revisión en un contexto de usuario especificado.

El número de orígenes de la propiedad SOURCELIST es ilimitado.

Sintaxis

UINT MsiSourceListAddSourceW(
  [in] LPCWSTR szProduct,
  [in] LPCWSTR szUserName,
  [in] DWORD   dwReserved,
  [in] LPCWSTR szSource
);

Parámetros

[in] szProduct

ProductCode del producto que se va a modificar.

[in] szUserName

Nombre de usuario de una instalación por usuario. En Windows 2000 o Windows XP, el nombre de usuario siempre debe tener el formato DOMAIN\USERNAME (o MACHINENAME\USERNAME para un usuario local).

Cadena vacía o NULL para una instalación por máquina.

[in] dwReserved

Reservado para uso futuro. Este valor debe establecerse en 0.

[in] szSource

Puntero a la cadena que especifica el origen.

Valor devuelto

Código devuelto	Descripción
ERROR_ACCESS_DENIED	El usuario no tiene la capacidad de agregar un origen.
ERROR_BAD_CONFIGURATION	Los datos de configuración están dañados.
ERROR_BAD_USERNAME	No se pudo resolver el nombre de usuario.
ERROR_FUNCTION_FAILED	La función no se realizó correctamente.
ERROR_INSTALL_SERVICE_FAILURE	No se pudo acceder al servicio del instalador.
ERROR_INVALID_PARAMETER	Se pasó un parámetro no válido a la función.
ERROR_SUCCESS	Se agregó el origen.
ERROR_UNKNOWN_PRODUCT	El producto especificado es desconocido.

Comentarios

Un administrador puede modificar las instalaciones por máquina, sus propias instalaciones no administradas por usuario y las instalaciones administradas por usuario para cualquier usuario. Un no administrador solo puede modificar las instalaciones por máquina y sus propias instalaciones (administradas o no administradas) por usuario. Los usuarios se pueden habilitar para buscar orígenes estableciendo la directiva . Para obtener más información, consulte las directivas DisableBrowse, AllowLockdownBrowse y AlwaysInstallElevated .

Tenga en cuenta que esta función simplemente agrega el nuevo origen a la lista de orígenes válidos. Si se usó otro origen para instalar el producto, el nuevo origen no se usará hasta que el origen actual no esté disponible.

Es responsabilidad del autor de la llamada asegurarse de que el origen proporcionado es una imagen de origen válida para el producto.

Si el nombre de usuario es una cadena vacía o NULL, la función funciona en la instalación por máquina del producto. En este caso, si el producto se instala solo en el estado por usuario, la función devuelve ERROR_UNKNOWN_PRODUCT.

Si el nombre de usuario no es una cadena vacía o NULL, especifica el nombre del usuario cuya instalación del producto se modifica. Si el nombre de usuario es el nombre de usuario actual, la función intenta modificar primero una instalación no administrada del producto. Si no se puede encontrar ninguna instalación no administrada del producto, la función intenta modificar una instalación administrada por usuario del producto. Si no se pueden encontrar instalaciones administradas o no administradas por usuario del producto, la función devuelve ERROR_UNKNOWN_PRODUCT, incluso si el producto está instalado por máquina.

Esta función no puede modificar una instalación no administrada para ningún usuario además del usuario actual. Si el nombre de usuario no es una cadena vacía o NULL, pero no es el usuario actual, la función solo comprueba si hay una instalación administrada por usuario del producto para el usuario especificado. Si el producto no está instalado como administrado por usuario para el usuario especificado, la función devuelve ERROR_UNKNOWN_PRODUCT, incluso si el producto está instalado por máquina.

Nota

El encabezado msi.h define MsiSourceListAddSource como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP. Consulte Windows Installer para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
Plataforma de destino	Windows
Encabezado	msi.h
Library	Msi.lib
Archivo DLL	Msi.dll