Fungsi MonikerCommonPrefixWith (objbase.h)

Artikel
02/29/2024

Membuat moniker baru berdasarkan awalan umum yang dibagikan moniker ini (yang terdiri dari data objek moniker ini) dengan moniker lain.

Fungsi ini dimaksudkan untuk dipanggil hanya dalam implementasi IMoniker::CommonPrefixWith.

Sintaks

HRESULT MonikerCommonPrefixWith(
  [in]  LPMONIKER pmkThis,
  [in]  LPMONIKER pmkOther,
  [out] LPMONIKER *ppmkCommon
);

Parameter

[in] pmkThis

Penunjuk ke antarmuka IMoniker pada salah satu moniker yang awalan umumnya dicari; biasanya moniker tempat panggilan ini digunakan untuk mengimplementasikan IMoniker::CommonPrefixWith.

[in] pmkOther

Pointer ke antarmuka IMoniker pada moniker untuk dibandingkan dengan moniker pertama.

[out] ppmkCommon

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

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Awalan umum ada yang bukan pmkThis maupun pmkOther.
MK_S_HIM	Seluruh moniker pmkOther adalah awalan dari pmkThis moniker.
MK_S_ME	Seluruh pmkThis moniker adalah awalan dari pmkOther moniker.
MK_S_US	pmkThis dan pmkOther monikers sama.
MK_E_NOPREFIX	Moniker tidak memiliki awalan umum.
MK_E_NOTBINDABLE	Fungsi ini dipanggil pada moniker relatif. Tidak bermakna untuk mengambil awalan umum dari moniker relatif.

Keterangan

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

Anda harus memanggil fungsi ini hanya jika pmkThis dan pmkOther 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::CommonPrefixWith

Bagikan melalui