Función MsiSourceListAddMediaDiskA (msi.h)
La función MsiSourceListAddMediaDisk agrega o actualiza un disco del origen multimedia de un producto o revisión registrados. Si el disco especificado ya existe, se actualiza con los nuevos valores. Si el disco especificado no existe, se crea una nueva entrada de disco con los nuevos valores.
Sintaxis
UINT MsiSourceListAddMediaDiskA(
[in] LPCSTR szProductCodeOrPatchCode,
[in, optional] LPCSTR szUserSid,
[in] MSIINSTALLCONTEXT dwContext,
[in] DWORD dwOptions,
[in] DWORD dwDiskId,
[in] LPCSTR szVolumeLabel,
[in, optional] LPCSTR szDiskPrompt
);
Parámetros
[in] szProductCodeOrPatchCode
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 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 se resuelve. Un SID incorrecto puede devolver ERROR_UNKNOWN_PRODUCT o ERROR_UNKNOWN_PATCH.
[in] dwContext
Este parámetro especifica el contexto de la instancia de producto o revisión. Este parámetro puede contener uno de los valores siguientes.
[in] dwOptions
El valor dwOptions especifica el significado de szProductCodeOrPatchCode.
| Marca | Significado |
|---|---|
|
szProductCodeOrPatchCode es un GUID de código de producto. |
|
szProductCodeOrPatchCode es un GUID de código de revisión. |
[in] dwDiskId
Este parámetro proporciona el id. del disco que se va a agregar o actualizar.
[in] szVolumeLabel
szVolumeLabel proporciona la etiqueta del disco que se va a agregar o actualizar. Una actualización sobrescribe la etiqueta de volumen existente en el registro. Para cambiar solo el símbolo del sistema del disco, obtenga la etiqueta de volumen existente del Registro y proporciónela en esta llamada junto con el nuevo símbolo del sistema de disco. Pasar una cadena NULL o vacía para szVolumeLabel registra una cadena vacía (0 bytes de longitud) como etiqueta de volumen.
[in, optional] szDiskPrompt
En la entrada a MsiSourceListAddMediaDisk, szDiskPrompt proporciona el símbolo del sistema de disco del disco que se va a agregar o actualizar. Una actualización sobrescribe el símbolo del sistema de disco registrado.
Para cambiar solo la etiqueta de volumen, obtenga el símbolo del sistema de disco existente que está registrado y proporciónelo al llamar a MsiSourceListAddMediaDisk junto con la nueva etiqueta de volumen. Pasar NULL o una cadena vacía registra una cadena vacía (0 bytes de longitud) como símbolo del sistema del disco.
Valor devuelto
La función MsiSourceListAddMediaDisk devuelve los valores siguientes.
| Valor | Significado |
|---|---|
|
El usuario no tiene la capacidad de leer el origen multimedia especificado ni el producto o la revisión especificados. Esto no indica si se encontró un origen multimedia, un producto o una 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. |
|
El valor se reordenó correctamente. |
|
No se encontró la revisión. |
|
No se encontró el producto. |
|
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 no administrado por usuario de otro usuario.
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 un producto o una instancia de 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 origen de revisión o producto. Los usuarios se pueden habilitar para buscar orígenes estableciendo la directiva . Para obtener más información, vea DisableBrowse, AllowLockdownBrowse, AllowLockDownMedia y AlwaysInstallElevated .
Nota:
El encabezado msi.h define MsiSourceListAddMediaDisk 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 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