Fungsi CreateFileMoniker (objbase.h)

Artikel
02/29/2024

Membuat moniker file berdasarkan jalur yang ditentukan.

Sintaks

HRESULT CreateFileMoniker(
  [in]  LPCOLESTR lpszPathName,
  [out] LPMONIKER *ppmk
);

Parameter

[in] lpszPathName

Jalur di mana moniker ini akan didasarkan.

Parameter ini dapat menentukan jalur relatif, jalur UNC, atau jalur berbasis huruf kandar. Jika berdasarkan jalur relatif, moniker yang dihasilkan harus disusam ke moniker file lain sebelum dapat diikat.

[out] ppmk

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

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Moniker berhasil dibuat.
MK_E_SYNTAX	Ada kesalahan dalam sintaks jalur.

Keterangan

CreateFileMoniker membuat moniker untuk objek yang disimpan dalam file. Penyedia moniker (objek yang menyediakan moniker ke objek lain) dapat memanggil fungsi ini untuk membuat moniker untuk mengidentifikasi objek berbasis file yang dikontrolnya, dan kemudian dapat membuat penunjuk ke moniker ini tersedia untuk objek lain. Objek yang diidentifikasi oleh moniker file juga harus mengimplementasikan antarmuka IPersistFile sehingga dapat dimuat saat moniker file terikat.

Ketika setiap objek berada dalam filenya sendiri, seperti dalam aplikasi server OLE yang hanya mendukung penautan ke dokumen berbasis file secara keseluruhan, moniker file adalah satu-satunya jenis moniker yang diperlukan. Untuk mengidentifikasi objek yang lebih kecil dari file, penyedia moniker harus menggunakan jenis moniker lain (seperti moniker item) selain moniker file, membuat moniker komposit. Moniker komposit akan diperlukan dalam aplikasi server OLE yang mendukung penautan ke objek yang lebih kecil dari dokumen (seperti bagian dokumen atau objek yang disematkan).

Moniker file dapat dikomposisikan ke kanan hanya dari moniker file lain ketika moniker pertama didasarkan pada jalur absolut dan yang lainnya adalah jalur relatif, menghasilkan moniker file tunggal berdasarkan kombinasi dua jalur. Moniker yang terdiri dari kanan moniker lain harus menjadi penyempurnaan moniker tersebut, dan file moniker mewakili unit penyimpanan terbesar. Untuk mengidentifikasi objek yang disimpan dalam file, Anda akan menyusun jenis moniker lain (biasanya moniker item) di sebelah kanan moniker file.

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
Set API	ext-ms-win-com-ole32-l1-1-4 (diperkenalkan dalam Windows 10, versi 10.0.14393)

Lihat juga

IMoniker

Bagikan melalui