Fungsi MsiGetShortcutTargetA (msi.h)

Artikel
08/24/2023

Fungsi MsiGetShortcutTarget memeriksa pintasan dan mengembalikan produk, nama fitur, dan komponennya jika tersedia.

Sintaks

UINT MsiGetShortcutTargetA(
  [in]  LPCSTR szShortcutPath,
  [out] LPSTR  szProductCode,
  [out] LPSTR  szFeatureId,
  [out] LPSTR  szComponentCode
);

Parameter

[in] szShortcutPath

String yang dihentikan null yang menentukan jalur lengkap ke pintasan.

[out] szProductCode

GUID untuk kode produk pintasan. Panjang buffer string ini harus 39 karakter. 38 karakter pertama adalah untuk GUID, dan karakter terakhir adalah untuk karakter null yang mengakhiri. Parameter ini dapat berupa null.

[out] szFeatureId

Nama fitur pintasan. Panjang buffer string harus MAX_FEATURE_CHARS+1 karakter. Parameter ini dapat berupa null.

[out] szComponentCode

GUID kode komponen. Panjang buffer string ini harus 39 karakter. 38 karakter pertama adalah untuk GUID, dan karakter terakhir adalah untuk karakter null yang mengakhiri. Parameter ini dapat berupa null.

Menampilkan nilai

Fungsi ini mengembalikan UINT.

Keterangan

Jika fungsi gagal, dan pintasan ada, konten reguler pintasan dapat diakses melalui antarmuka IShellLink .

Jika tidak, status target dapat ditentukan dengan menggunakan Fungsi Pemilihan Penginstal.

Catatan

Header msi.h mendefinisikan MsiGetShortcutTarget sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscessor 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


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. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Penginstal Windows.
Target Platform	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll