Función MsiSourceListSetInfoA (msi.h)
La función MsiSourceListSetInfo establece información sobre la lista de origen de un producto o revisión en un contexto específico.
Sintaxis
UINT MsiSourceListSetInfoA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] LPCSTR szProperty,
[in] LPCSTR szValue
);
Parámetros
[in] szProductCodeOrPatchCode
El ProductCode o guid de revisión del producto o revisión. Use una cadena terminada en NULL. Si la cadena tiene más de 39 caracteres, la función produce un error y devuelve ERROR_INVALID_PARAMETER. Este parámetro no puede ser NULL.
[in, optional] szUserSid
Este parámetro puede ser un SID de cadena que especifica la cuenta de usuario que contiene el producto o la revisión. El SID no se valida ni resuelve. Un SID incorrecto puede devolver ERROR_UNKNOWN_PRODUCT o ERROR_UNKNOWN_PATCH. Al hacer referencia a un contexto de máquina, szUserSID debe ser NULL y dwContext debe ser MSIINSTALLCONTEXT_MACHINE.
[in] dwContext
Este parámetro especifica el contexto de la instancia de producto o revisión. Este parámetro puede contener uno de los siguientes valores.
[in] dwOptions
El valor dwOptions de
Si la propiedad que se establece es "LastUsedSource", este parámetro también especifica el tipo de origen como red o dirección URL. En este caso, el parámetro dwOptions debe ser una combinación de una de las siguientes constantes MSISOURCETYPE_ y una de las siguientes constantes MSICODE_.
[in] szProperty
El parámetro szProperty indica el valor de propiedad que se va a establecer. No todas las propiedades que se pueden recuperar mediante MsiSourceListGetInfo se pueden establecer mediante una llamada a MsiSourceListSetInfo. El valor szProperty puede ser uno de los siguientes valores.
| Nombre | Significado |
|---|---|
|
Ruta de acceso relativa a la raíz del medio de instalación. |
|
Plantilla de solicitud que se usa al solicitar al usuario los medios de instalación. |
|
La ubicación de origen usada más recientemente para el producto. Si el origen no está registrado, la función llama a MsiSourceListAddSourceEx para registrarlo. Si el registro se realiza correctamente, la función establece el origen como LastUsedSource. |
|
Nombre del paquete de Windows Installer o del paquete de revisión en el origen. |
[in] szValue
Nuevo valor de la propiedad . No se realiza ninguna validación del nuevo valor. Este valor no se puede null. Puede ser una cadena vacía.
Valor devuelto
La función MsiSourceListSetInfo devuelve los valores siguientes.
| Valor | Significado |
|---|---|
|
El usuario no tiene la capacidad de establecer la lista de origen para el producto especificado. |
|
Los datos de configuración están dañados. |
|
No se pudo acceder al servicio Windows Installer. |
|
Se pasó un parámetro no válido a la función . |
|
Se estableció la propiedad . |
|
No se encontró la revisión. |
|
No se encontró el producto. |
|
No se encontró la propiedad de origen. |
|
Error interno inesperado. |
Observaciones
Los administradores pueden modificar la instalación de una instancia de producto o revisión que existe en el contexto de la máquina o en su propio contexto por usuario (administrado o no administrado). Pueden modificar la instalación de una instancia de producto o revisión que existe en el contexto administrado por usuario de cualquier usuario. Los administradores no pueden modificar la instalación de otro usuario de una instancia de producto o revisión que exista en ese contexto por usuario no administrado.
Los no administradores no pueden modificar la instalación de una instancia de producto o revisión que existe en el contexto por usuario de otro usuario (administrado o no administrado). Pueden modificar la instalación de una instancia de producto o revisión que existe bajo su propio contexto por usuario y no administrado. Pueden modificar la instalación de un producto o una instancia de revisión en el contexto de la máquina o su propio contexto administrado por usuario solo si están habilitados para buscar un producto o origen de revisión. Los usuarios se pueden habilitar para buscar orígenes estableciendo la directiva . Para obtener más información, consulte la DisableBrowse, AllowLockdownBrowsey directivas de AlwaysInstallElevated.
Una excepción a la regla anterior es establecer "LastUsedSource" en uno de los orígenes registrados. Si el origen ya está registrado, un no administrador puede establecer "LastUsedSource" en sus propias instalaciones (administradas o no administradas) y por máquina, independientemente de las directivas.
Nota
El encabezado msi.h define MsiSourceListSetInfo 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | 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. Consulte Windows Installer Run-Time Requirements (Requisitos de Windows Installer) para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer. |
| de la plataforma de destino de |
Windows |
| encabezado de |
msi.h |
| biblioteca de |
Msi.lib |
| DLL de |
Msi.dll |
Consulte también
contexto de instalación de
no compatibles con Windows Installer 2.0 y versiones anteriores