Metode IShellLinkA::SetRelativePath (shobjidl_core.h)

Artikel
03/13/2024

Mengatur jalur relatif ke objek tautan Shell.

Sintaks

HRESULT SetRelativePath(
  LPCSTR 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.

Nilai kembali

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:\.

Anda dapat membantu proses resolusi dengan membuat tautan asli dengan jalur relatif sebelum pintasan disimpan.

::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)