Función MsiSourceListForceResolutionExA (msi.h)

La función MsiSourceListForceResolutionEx quita el registro de la propiedad denominada "LastUsedSource". Esta función no afecta a la lista de origen registrada. Siempre que el instalador requiera que el origen vuelva a instalar un producto o una revisión, primero intenta el origen registrado como "LastUsedSource". Si se produce un error o si falta ese registro, el instalador busca en los demás orígenes registrados hasta que encuentre un origen válido o hasta que se agote la lista de orígenes. Al borrar el registro "LastUsedSource", el instalador hace que realice una resolución de origen en los orígenes registrados la próxima vez que requiera el origen.

Sintaxis

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

Parámetros

[in] szProductCodeOrPatchCode

Guid de ProductCode o 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. El uso del SID de la máquina ("S-1-5-18") devuelve ERROR_INVALID PARAMETER. Al hacer referencia a la cuenta de usuario actual, szUserSID puede ser NULL y dwContext puede ser MSIINSTALLCONTEXT_USERMANAGED o MSIINSTALLCONTEXT_USERUNMANAGED.

[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.

Tipo de contexto Significado
MSIINSTALLCONTEXT_USERMANAGED
La instancia de producto o revisión existe en el contexto administrado por usuario.
MSIINSTALLCONTEXT_USERUNMANAGED
La instancia de producto o revisión existe en el contexto no administrado por usuario.
MSIINSTALLCONTEXT_MACHINE
La instancia de producto o revisión existe en el contexto por máquina.

[in] dwOptions

El valor dwOptions determina la interpretación del valor szProductCodeOrPatchCode .

Marca Significado
MSICODE_PRODUCT
szProductCodeOrPatchCode es un código de producto.
MSICODE_PATCH
szProductCodeOrPatchCode es un código de revisión.

Valor devuelto

La función MsiSourceListForceResolutionEx devuelve los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
El usuario no tiene la capacidad de modificar la lista de origen especificada. No indica si se encontró el producto o la revisión.
ERROR_BAD_CONFIGURATION
Los datos de configuración están dañados.
ERROR_INSTALL_SERVICE_FAILURE
No se pudo acceder al servicio Windows Installer
ERROR_INVALID_PARAMETER
Se pasó un parámetro no válido a la función.
ERROR_SUCCESS
Se ha borrado el registro "LastUsedSource".
ERROR_UNKNOWN_PATCH
No se encontró la revisión.
ERROR_UNKNOWN_PRODUCT
No se encontró el producto o la revisión especificados.
ERROR_FUNCTION_FAILED
Error interno inesperado.

Comentarios

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 del otro usuario.

Los usuarios que no son 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 en su propio contexto no administrado por usuario. 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, vea DisableBrowse, AllowLockdownBrowse y Directivas AlwaysInstallElevated .

Nota:

El encabezado msi.h define MsiSourceListForceResolutionEx 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

   
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 3.0, o posterior, 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

Consulte también

No se admite en Windows Installer 2.0 ni en versiones anteriores

ProductCode

Resistencia de origen