Metode IShellLinkW::SetRelativePath (shobjidl_core.h)
Mengatur jalur relatif ke objek tautan Shell.
Sintaks
HRESULT SetRelativePath(
LPCWSTR pszPathRel,
DWORD dwReserved
);
Parameter
pszPathRel
Jenis: LPCTSTR
Alamat buffer yang berisi jalur file pintasan yang sepenuhnya memenuhi syarat, relatif terhadap resolusi pintasan yang harus dilakukan. Ini harus berupa nama file, bukan nama folder.
dwReserved
Jenis: DWORD
Dicadangkan. Atur parameter ini ke nol.
Mengembalikan nilai
Jenis: HRESULT
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Klien biasanya mendefinisikan tautan relatif ketika dapat dipindahkan bersama dengan targetnya, menyebabkan jalur absolut menjadi tidak valid. Metode SetRelativePath dapat digunakan untuk membantu proses resolusi tautan menemukan targetnya berdasarkan awalan jalur umum antara target dan jalur relatif. Untuk membantu dalam proses resolusi, klien harus mengatur jalur relatif sebagai bagian dari proses pembuatan tautan.
Contoh
Pertimbangkan skenario berikut:
- Anda memiliki tautan: c:\MyLink.lnk.
- Target tautan c:\MyDocs\MyFile.txt.
- Anda ingin memindahkan tautan dan MyDocs\MyFile.txt ke d:\.
::SetRelativePath("c:\MyLink.lnk", NULL);
Sebelum pintasan diselesaikan, atur jalur relatif baru, dan Kode penyelesaian akan menemukan file di lokasi barunya.
::SetRelativePath("d:\MyLink.lnk", NULL);
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | shobjidl_core.h |
DLL | Shell32.dll (versi 4.0 atau yang lebih baru) |
Lihat juga
IShellLinkA
IShellLinkW