Metode IRunnableObject::SetContainedObject (objidl.h)

Memberi tahu objek bahwa objek disematkan dalam kontainer OLE, yang memastikan bahwa penghitungan referensi dilakukan dengan benar untuk kontainer yang mendukung tautan ke objek yang disematkan.

Sintaks

HRESULT SetContainedObject(
  [in] BOOL fContained
);

Parameter

[in] fContained

TRUE menentukan bahwa objek terkandung dalam kontainer OLE. FALSE menunjukkan bahwa itu tidak.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, dan S_OK.

Keterangan

Metode SetContainedObject memungkinkan kontainer untuk menginformasikan handler objek bahwa itu disematkan dalam kontainer, daripada bertindak sebagai tautan. Panggilan ini mengubah referensi kontainer pada objek dari kuat, default untuk koneksi eksternal, menjadi lemah. Ketika objek berjalan dengan jelas, metode ini sedikit signifikansi karena pengguna akhir memiliki kunci pada objek. Selama pembaruan senyap dari sumber tautan yang disematkan, namun, kontainer seharusnya tidak dapat menahan objek dalam status berjalan setelah tautan rusak. Untuk alasan ini, referensi kontainer ke objek harus lemah.

Catatan untuk Penelepon

Aplikasi kontainer harus memanggil SetContainedObject jika mendukung penautan ke objek yang disematkan. Biasanya melakukan panggilan segera setelah memanggil OleLoad atau OleCreate dan tidak pernah memanggil metode lagi, bahkan sebelum ditutup. Selain itu, kontainer hampir selalu memanggil metode ini dengan fContained diatur ke TRUE. Penggunaan metode ini dengan fContained diatur ke FALSE jarang terjadi.

Memanggil SetContainedObject bersifat opsional hanya ketika Anda tahu bahwa objek yang disematkan tidak akan dirujuk oleh klien mana pun selain kontainer. Jika aplikasi kontainer Anda tidak mendukung penautan ke objek yang disematkan; lebih disukai, tetapi tidak perlu, untuk memanggil SetContainedObject.

OleSetContainedObject adalah fungsi pembantu yang dengan mudah mengemas ulang fungsionalitas yang ditawarkan oleh SetContainedObject. Dengan rilis OLE 2.01, implementasi OleSetContainedObject diubah untuk memanggil QueryInterface, meminta IRunnableObject, lalu memanggil IRunnableObject::SetContainedObject. Dengan kata lain, Anda dapat menggunakan antarmuka dan fungsi pembantu secara bergantian.

Persyaratan

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

Lihat juga

IRunnableObject

OleSetContainedObject