Fungsi MsiSetTargetPathA (msiquery.h)

Artikel
08/25/2023

Fungsi MsiSetTargetPath menetapkan jalur target lengkap untuk folder dalam tabel Direktori.

Sintaks

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

Parameter

[in] hInstall

Tangani penginstalan yang disediakan untuk tindakan kustom DLL atau diperoleh melalui MsiOpenPackage, MsiOpenPackageEx, atau MsiOpenProduct.

[in] szFolder

Menentukan pengidentifikasi folder. Ini adalah kunci primer dalam tabel Direktori.

[in] szFolderPath

Menentukan jalur lengkap untuk folder, berakhiran pemisah direktori.

Nilai kembali

Fungsi MsiSetTargetPath mengembalikan nilai berikut:

Keterangan

Fungsi MsiSetTargetPath mengubah spesifikasi jalur untuk direktori target bernama dalam tabel Direktori dalam memori. Selain itu, spesifikasi jalur semua objek jalur lainnya dalam tabel yang subordinat atau setara dengan jalur yang diubah diperbarui untuk mencerminkan perubahan. Properti untuk setiap jalur yang terpengaruh juga diperbarui.

MsiSetTargetPath gagal jika direktori yang dipilih hanya dibaca.

Jika terjadi kesalahan dalam fungsi ini, semua jalur dan properti yang diperbarui kembali ke nilai sebelumnya. Oleh karena itu, aman untuk memperlakukan kesalahan yang dikembalikan oleh fungsi ini sebagai nonfatal.

Jangan mencoba mengonfigurasi jalur target jika komponen yang menggunakan jalur tersebut sudah diinstal untuk pengguna saat ini atau untuk pengguna yang berbeda. Periksa properti ProductState sebelum memanggil MsiSetTargetPath untuk menentukan apakah produk yang berisi komponen ini diinstal.

Lihat Memanggil Fungsi Database Dari Program.

Jika fungsi gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan MsiGetLastErrorRecord.

Catatan

Header msiquery.h mendefinisikan MsiSetTargetPath sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Installer 5.0 di Windows Server 2012, Windows 8, Windows Server 2008 R2 atau Windows 7. Windows Installer 4.0 atau Windows Installer 4.5 di Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP
Target Platform	Windows
Header	msiquery.h
Pustaka	Msi.lib
DLL	Msi.dll

Lihat juga

Fungsi Lokasi Alat Penginstal

Bagikan melalui