Bagaimana untuk mengumpulkan antarmuka di apartemen di Visual C++

Marshal.exe adalah contoh yang menunjukkan cara yang berbeda marshaling antarmuka di apartemen.

Berkas berikut ini tersedia untuk diunduh dari Pusat Unduhan Microsoft:

Download paket Marshal.exe sekarang. (http://download.microsoft.com/download/vc60pro/info2/1/WIN98/EN-US/Marshal.exe)

Untuk informasi selengkapnya tentang cara mengunduh berkas dukungan Microsoft, klik nomor artikel berikut ini untuk melihat artikel di Pangkalan Pengetahuan Microsoft:Microsoft telah memindai berkas ini dari virus. Microsoft menggunakan perangkat lunak pendeteksi virus terbaru yang tersedia pada tanggal saat berkas dikirimkan. Berkas tersebut disimpan di server aman, yang membantu mencegah segala perubahan tidak sah terhadap berkas.

Single-Threaded Apartemen (STA) adalah benang yang diinisialisasi dengan CoInitialize() atau CoInitializeEx (NULL, COINIT_APARTMENTTHREADED). Juga, setiap benang lainnya di proses yang sama yang menggunakan COM juga harus menghubungi CoInitialize() atau CoInitializeEx() untuk menginisialisasi COM untuk thread yang.

Jika Anda membuat objek COM di satu STA Thread, Anda tidak bisa lewat antarmuka pointer ke thread STA lain dan memanggil pada penunjuk itu. Karena panggilan ke objek STA seharusnya serial, COM memberlakukan ini hanya memungkinkan satu benang untuk panggilan ke STA objek ( thread di mana itu diciptakan). Jika penunjuk antarmuka Anda lulus untuk kedua STA thread adalah pointer ke proxy, Anda akan mendapatkan error HRESULT 0x8001010E atau RPC_E_WRONG_THREAD (aplikasi disebut antarmuka yang telah mengerahkan untuk thread berbeda). Jika antarmuka pointer adalah pointer langsung ke objek, COM tidak akan menegakkan serialisasi, Anda tidak akan mendapatkan kesalahan di atas, dan panggilan metode antarmuka akan dibuat. Namun, hal ini masih ilegal perilaku dari klien.

Anda masih dapat memanggil metode STA objek dari benang STA berbeda asalkan Anda melakukannya melalui proxy. Proxy adalah salinan dari antarmuka yang Anda mendapatkan melalui marshaling/unmarshaling. Ketika Anda membuat panggilan melalui proxy, COM membuat Thread switch dan panggilan berakhir mengeksekusi dalam konteks thread di mana STA objek diciptakan.

Ada tiga cara untuk Marsekal/unmarshal sebuah antarmuka untuk thread STA lain:

1. CoMarshalInterThreadInterfaceInStream() dan CoGetInterfaceAndReleaseStream(): Kelemahan satu untuk menggunakan metode ini adalah antarmuka hanya dapat unmarshaled sekali. Itu adalah, jika Anda memerlukan akses ke objek yang sama dari beberapa STA benang, metode ini tidak akan bekerja.
2. CoMarshalInterface() dan CoUnMarshalInterface(): Metode ini lebih fleksibel karena Anda dapat mengumpulkan antarmuka sekali dan unmarshal antarmuka sebanyak yang Anda inginkan; sebagai contoh, menetapkan MSHLFLGS_TABLEWEAK atau MSHLFLGS_TABLESTRONG ketika marshaling antarmuka. Tapi itu juga membutuhkan kode lebih karena Anda harus membuat IStream, mengatur penunjuk mencari dan membersihkan paket Marsekal melalui CoReleaseMarshalData(). Ketika marshaling petunjuk untuk proxy Anda harus Windows NT 4.0 Service Pack 4 atau kemudian, Windows 98 atau Windows 95 dengan DCOM 1,2 atau kemudian diinstal. Juga ketika menggunakan MSHLFLGS_TABLESTRONG bendera Anda harus Windows 2000 atau sesudahnya.
3. Global antarmuka Table(GIT): GIT adalah sebuah objek COM yang memungkinkan Anda untuk menyimpan antarmuka di satu STA benang dan mendapatkan akses ke proxy di thread STA lain. Ini adalah hanya tersedia dengan Windows NT 4.0 Service Pack 3 atau kemudian, Windows 98 atau Windows 95 dengan DCOM 1.1 atau kemudian diinstal.

Marshal.exe berisi TSTMARSH yang merupakan proyek utama. Ini berisi server ATL EXE yang menerapkan ITest. ITest memiliki salah satu metode yang disebut ToUpper(), yang mengubah string untuk huruf besar. Sub-proyek yang disebut klien adalah juga disertakan. Client.CPP adalah di mana semua metode marshaling/unmarshaling ditampilkan. Setiap metode menciptakan contoh tes objek, Marsekal ITest antarmuka dan menciptakan sebuah thread. Dalam setiap benang, antarmuka ITest adalah unmarshaled dan metode ToUpper() dipanggil untuk mengkonversi string. Anda harus melihat output dalam jendela debug: "ini adalah OUTPUT dari benang # N".

Untuk informasi selengkapnya, klik nomor artikel berikut untuk melihat artikel di Pangkalan Pengetahuan Microsoft: