Fungsi MonikerRelativePathTo (objbase.h)

Artikel
02/29/2024

Menyediakan moniker yang, ketika disusun ke akhir moniker pertama yang ditentukan (atau yang memiliki struktur serupa), menghasilkan moniker kedua yang ditentukan.

Fungsi ini hanya ditujukan untuk digunakan oleh implementasi IMoniker::RelativePathTo .

Sintaks

HRESULT MonikerRelativePathTo(
  [in]  LPMONIKER pmkSrc,
  [in]  LPMONIKER pmkDest,
  [out] LPMONIKER *ppmkRelPath,
  [in]  BOOL      dwReserved
);

Parameter

[in] pmkSrc

Penunjuk ke antarmuka IMoniker pada moniker yang, ketika disusun dengan moniker relatif yang akan dibuat, menghasilkan pmkDest. Moniker ini mengidentifikasi "sumber" moniker relatif yang akan dibuat.

[in] pmkDest

Penunjuk ke antarmuka IMoniker pada moniker untuk diekspresikan relatif terhadap pmkSrc. Moniker ini mengidentifikasi tujuan moniker relatif yang akan dibuat.

[out] ppmkRelPath

Alamat variabel pointer IMoniker* yang menerima penunjuk antarmuka ke moniker relatif baru. Ketika berhasil, fungsi telah memanggil AddRef pada moniker dan pemanggil bertanggung jawab untuk memanggil Rilis. Jika terjadi kesalahan, nilai penunjuk antarmuka adalah NULL.

[in] dwReserved

Parameter ini dicadangkan dan harus nonzero.

Nilai kembali

Fungsi ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan E_UNEXPECTED, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Jalur relatif yang bermakna telah dikembalikan.
MK_S_HIM	Satu-satunya bentuk jalur relatif adalah moniker lainnya.
MK_E_NOTBINDABLE	Parameter pmkSrc adalah moniker relatif, seperti moniker item, dan harus terdiri dengan moniker kontainernya sebelum jalur relatif dapat ditentukan.

Keterangan

Implementasi IMoniker::RelativePathTo Anda harus terlebih dahulu memeriksa apakah moniker lainnya adalah jenis yang Anda kenali dan tangani dengan cara khusus. Jika tidak, Anda harus memanggil MonikerRelativePathTo, meneruskan dirinya sebagai pmkThis dan moniker lainnya sebagai pmkOther. MonikerRelativePathTo menangani kasus dengan benar di mana salah satu moniker adalah komposit generik.

Anda harus memanggil fungsi ini hanya jika pmkSrc dan pmkDest keduanya adalah moniker absolut, di mana moniker absolut adalah moniker file atau komposit generik yang komponen paling kirinya adalah moniker file, dan di mana moniker file mewakili jalur absolut. Jangan panggil fungsi ini pada moniker relatif.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	objbase.h
Pustaka	Ole32.lib
DLL	Ole32.dll

Lihat juga

IMoniker::RelativePathTo

Bagikan melalui