Fungsi CreateItemMoniker (objbase.h)
Membuat moniker item yang mengidentifikasi objek dalam objek yang berisi (biasanya dokumen gabungan).
Sintaks
HRESULT CreateItemMoniker(
[in] LPCOLESTR lpszDelim,
[in] LPCOLESTR lpszItem,
[out] LPMONIKER *ppmk
);
Parameter
[in] lpszDelim
Penunjuk ke string karakter lebar (dua byte per karakter) string yang dihentikan nol yang berisi pemisah (biasanya "!") digunakan untuk memisahkan nama tampilan item ini dari nama tampilan objek yang berisi.
[in] lpszItem
Penunjuk ke string yang dihentikan nol yang menunjukkan nama objek yang berisi untuk objek yang sedang diidentifikasi. Nama ini nantinya dapat digunakan untuk mengambil penunjuk ke objek dalam panggilan ke IOleItemContainer::GetObject.
[out] ppmk
Alamat variabel pointer IMoniker* yang menerima penunjuk antarmuka ke moniker item. Ketika berhasil, fungsi telah disebut AddRef pada moniker item dan pemanggil bertanggung jawab untuk memanggil Rilis. Jika terjadi kesalahan, penunjuk antarmuka yang disediakan memiliki nilai NULL .
Nilai kembali
Fungsi ini dapat mengembalikan nilai pengembalian standar E_OUTOFMEMORY dan S_OK.
Keterangan
Penyedia moniker, yang menyerahkan moniker untuk mengidentifikasi objeknya sehingga dapat diakses oleh pihak lain, akan memanggil CreateItemMoniker untuk mengidentifikasi objeknya dengan moniker item. Moniker item didasarkan pada string, dan mengidentifikasi objek yang terkandung dalam objek lain dan dapat diidentifikasi secara individual menggunakan string. Objek yang berisi juga harus mengimplementasikan antarmuka IOleContainer .
Sebagian besar penyedia moniker adalah aplikasi OLE yang mendukung penautan. Aplikasi yang mendukung penautan ke objek yang lebih kecil dari dokumen berbasis file, seperti aplikasi server yang memungkinkan penautan ke pilihan dalam dokumen, harus menggunakan moniker item untuk mengidentifikasi objek. Aplikasi kontainer yang memungkinkan penautan ke objek yang disematkan menggunakan moniker item untuk mengidentifikasi objek yang disematkan.
Parameter lpszItem adalah nama yang digunakan oleh dokumen untuk mengidentifikasi objek secara unik. Misalnya, jika objek yang diidentifikasi adalah rentang sel di spreadsheet, nama yang sesuai mungkin seperti "A1:E7." Nama yang sesuai ketika objek yang diidentifikasi adalah objek yang disematkan mungkin seperti "embedobj1." Objek yang berisi harus menyediakan implementasi antarmuka IOleItemContainer yang dapat menafsirkan nama ini dan menemukan objek yang sesuai. Ini memungkinkan moniker item terikat ke objek yang diidentifikasinya.
Moniker item tidak digunakan dalam isolasi. Mereka harus terdiri dengan moniker yang mengidentifikasi objek yang berisi juga. Misalnya, jika objek yang diidentifikasi adalah rentang sel yang terkandung dalam dokumen berbasis file, moniker item yang mengidentifikasi objek tersebut harus terdiri dari file moniker yang mengidentifikasi dokumen tersebut, menghasilkan moniker komposit yang setara dengan "C:\work\sales.xls! A1:E7."
Kontainer berlapis juga diizinkan, seperti dalam kasus di mana objek terkandung dalam objek yang disematkan di dalam dokumen lain. Moniker lengkap dari objek seperti itu akan setara dengan "C:\work\report.doc!embedobj1! A1:E7." Dalam hal ini, setiap objek yang berisi harus memanggil CreateItemMoniker dan menyediakan implementasi antarmuka IOleItemContainer sendiri.
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-0 (diperkenalkan dalam Windows 8) |