Función MsiSourceListClearAllExA (msi.h)
La función MsiSourceListClearAllEx quita todos los orígenes existentes de un tipo de origen determinado para el producto especificado o la instancia de revisión. El registro de revisiones también se quita si se quita el único origen de la revisión y si la revisión no está instalada como una nueva revisión por parte de cualquier cliente en el mismo contexto. Especificar que MsiSourceListClearAllEx quite el origen actual de este producto o revisión obliga al instalador a buscar la lista de origen para un origen la próxima vez que se requiera un origen.
Sintaxis
UINT MsiSourceListClearAllExA(
[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.
[in] dwOptions
El valor dwOptions determina la interpretación del valor szProductCodeOrPatchCode y el tipo de orígenes que se van a borrar. Este parámetro debe ser una combinación de una de las siguientes constantes MSISOURCETYPE_* y una de las siguientes constantes MSICODE_*.
Valor devuelto
| Valor | Significado |
|---|---|
|
El usuario no tiene la capacidad de agregar o mover un origen. No indica si se encontró el producto o la revisión. |
|
Los datos de configuración están dañados. |
|
No se puede acceder al servicio Windows Installer. |
|
Se pasó un parámetro no válido a la función. |
|
Se quitaron todos los orígenes del tipo especificado. |
|
El producto especificado es desconocido. |
|
La revisión especificada es desconocida. |
|
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 MsiSourceListClearAllEx 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 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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de