Función MsiSourceListForceResolutionA (msi.h)
La función MsiSourceListForceResolution obliga al instalador a buscar la lista de origen de un origen de producto válido la próxima vez que se requiera un origen. Por ejemplo, cuando el instalador realiza una instalación o reinstalación, o cuando requiere la ruta de acceso de un componente establecido para ejecutarse desde el origen.
Sintaxis
UINT MsiSourceListForceResolutionA(
[in] LPCSTR szProduct,
[in] LPCSTR szUserName,
[in] DWORD dwReserved
);
Parámetros
[in] szProduct
ProductCode del producto que se va a modificar.
[in] szUserName
Nombre de usuario de una instalación por usuario. 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.
Valor devuelto
La función MsiSourceListForceResolution devuelve los valores siguientes.
| Valor | Significado |
|---|---|
|
El autor de la llamada no tiene acceso suficiente para forzar la resolución del producto. |
|
Los datos de configuración están dañados. |
|
El usuario especificado no es un usuario válido. |
|
No se pudo completar la función. |
|
No se pudo acceder al servicio de instalación. |
|
Se pasó un parámetro no válido a la función. |
|
La función se ha realizado correctamente. |
|
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.
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 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 MsiSourceListForceResolution 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 |