Metode IOleObject::SetHostNames (oleidl.h)

Artikel
08/25/2023

Menyediakan objek dengan nama aplikasi kontainernya dan dokumen majemuk tempatnya disematkan.

Sintaks

HRESULT SetHostNames(
  [in] LPCOLESTR szContainerApp,
  [in] LPCOLESTR szContainerObj
);

Parameter

[in] szContainerApp

Penunjuk ke nama aplikasi kontainer tempat objek berjalan.

[in] szContainerObj

Penunjuk ke nama dokumen campuran yang berisi objek . Jika Anda tidak ingin menampilkan nama dokumen gabungan, Anda dapat mengatur parameter ini ke NULL.

Menampilkan nilai

Metode ini mengembalikan S_OK pada keberhasilan.

Keterangan

Catatan untuk Penelepon

Panggil IOleObject::SetHostNames hanya untuk objek yang disematkan, karena untuk objek tertaut, sumber tautan menyediakan jendela pengeditan terpisah dan informasi bilah judulnya sendiri.

Catatan untuk Pelaksana

Aplikasi objek IOleObject::SetHostNames harus menyertakan modifikasi apa pun pada antarmuka penggunanya mungkin sesuai dengan status tersemat objek. Modifikasi tersebut biasanya akan mencakup menambahkan dan menghapus perintah menu dan mengubah teks yang ditampilkan di bilah judul jendela pengeditan.

Judul jendela lengkap untuk objek yang disematkan dalam aplikasi kontainer SDI atau aplikasi MDI dengan jendela anak yang dimaksimalkan akan muncul sebagai berikut:

&lt;object application name&gt; - &lt;object short type&gt; in &lt;container document&gt;

Jika tidak, judul harus:

&lt;object application name&gt; - &lt;container document&gt;

"Jenis pendek objek" mengacu pada bentuk nama objek yang cukup pendek untuk ditampilkan secara penuh dalam kotak daftar. Karena string identifikasi ini tidak disimpan sebagai bagian dari status persisten objek, IOleObject::SetHostNames harus dipanggil setiap kali objek dimuat atau dijalankan.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	oleidl.h

Lihat juga

IOleObject

IOleObject::GetUserType