Función MsiSetTargetPathA (msiquery.h)

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

Controle la instalación proporcionada a una acción personalizada de DLL o obtenida a través de MsiOpenPackage, MsiOpenPackageExo 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 siguientes valores:

Observaciones

La función MsiSetTargetPath cambia la especificación de ruta de acceso del directorio de destino denominado en la tabla de Directory 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. También se actualizan las propiedades de cada ruta de acceso afectada.

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 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 en Windows Server 2003 o Windows XP
de la plataforma de destino de	Windows
encabezado de	msiquery.h
biblioteca de	Msi.lib
DLL de	Msi.dll

Consulte también

funciones de ubicación del instalador