Función MsiSourceListClearMediaDiskA (msi.h)

Artículo
11/20/2024

La función MsiSourceListClearMediaDisk proporciona la capacidad de quitar un disco registrado existente en el origen multimedia de un producto o revisión en un contexto específico.

Sintaxis

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

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, se produce un error en la función y se 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.

Tipo de SID	Significado
NULL	NULL denota el usuario que ha iniciado sesión actualmente. Al hacer referencia a la cuenta de usuario actual, szUserSID puede ser NULL y dwContext puede ser MSIINSTALLCONTEXT_USERMANAGED o MSIINSTALLCONTEXT_USERUNMANAGED.
siD de usuario de	Especifica la enumeración de un usuario determinado del sistema. Un ejemplo de SID de usuario es "S-1-3-64-2415071341-1358098788-3127455600-2561".

Nota La cadena de SID especial s-1-5-18 (sistema) no se puede usar para enumerar productos o revisiones instalados según la máquina. Al establecer el valor del SID en s-1-5-18, se devuelve ERROR_INVALID_PARAMETER. Cuando dwContext solo se establece en MSIINSTALLCONTEXT_MACHINE, szUserSid debe ser NULL.

Nota No se debe usar la cadena de SID especial s-1-1-0 (todos). Se produce un error al establecer el valor del SID en s-1-1-0 y devuelve ERROR_INVALID_PARAM.

[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 por usuario no administrado.
MSIINSTALLCONTEXT_MACHINE	La instancia de producto o revisión existe en el contexto por máquina.

[in] dwOptions

El valor dwOptions de especifica el significado de szProductCodeOrPatchCode.

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

[in] dwDiskId

Este parámetro proporciona el identificador del disco que se va a quitar.

Valor devuelto

La función MsiSourceListClearMediaDisk devuelve los valores siguientes.

Valor	Significado
ERROR_ACCESS_DENIED	El usuario no tiene la capacidad de leer el origen de medios especificado o el producto o la revisión especificados. Esto no indica si se encontró un origen multimedia, un producto o una 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	El valor se quitó correctamente o no se encontró.
ERROR_UNKNOWN_PATCH	No se encontró la revisión.
ERROR_UNKNOWN_PRODUCT	No se encontró el producto.
ERROR_FUNCTION_FAILED	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.

Nota

El encabezado msi.h define MsiSourceListClearMediaDisk 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. Windows Installer 3.0 o posterior en Windows Server 2003 o Windows XP. 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

no compatibles con Windows Installer 2.0 y versiones anteriores

productCode

Compartir a través de