Función MsiSetTargetPathA (msiquery.h)

  • Artículo

La función MsiSetTargetPath establece la ruta de acceso de destino completa de una carpeta de la tabla Directory.

Sintaxis

UINT MsiSetTargetPathA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szFolder,
  [in] LPCSTR    szFolderPath
);

Parámetros

[in] hInstall

Identificador de la instalación proporcionada a una acción personalizada de DLL o obtenida a través de MsiOpenPackage, MsiOpenPackageEx o MsiOpenProduct.

[in] szFolder

Especifica el identificador de carpeta. Se trata de una clave principal en la tabla Directory.

[in] szFolderPath

Especifica la ruta de acceso completa de la carpeta, que termina en un separador de directorios.

Valor devuelto

La función MsiSetTargetPath devuelve los valores siguientes:

Comentarios

La función MsiSetTargetPath cambia la especificación de ruta de acceso del directorio de destino denominado en la tabla Directorio en memoria. Además, las especificaciones de ruta de acceso de todos los demás objetos de ruta de acceso de la tabla que son subordinados o equivalentes a la ruta de acceso modificada se actualizan para reflejar el cambio. Las propiedades de cada ruta de acceso afectada también se actualizan.

MsiSetTargetPath produce un error si el directorio seleccionado es de solo lectura.

Si se produce un error en esta función, todas las rutas de acceso y propiedades actualizadas se revierten a sus valores anteriores. Por lo tanto, es seguro tratar los errores devueltos por esta función como nofatal.

No intente configurar la ruta de acceso de destino si los componentes que usan esas rutas de acceso ya están instalados para el usuario actual o para otro usuario. Compruebe la propiedad ProductState antes de llamar a MsiSetTargetPath para determinar si el producto que contiene este componente está instalado.

Consulte Llamar a funciones de base de datos desde programas.

Si se produce un error en la función, puede obtener información de error extendida mediante MsiGetLastErrorRecord.

Nota

El encabezado msiquery.h define MsiSetTargetPath 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

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
Plataforma de destino Windows
Encabezado msiquery.h
Library Msi.lib
Archivo DLL Msi.dll

Consulte también

Funciones de ubicación del instalador