Fungsi CoCreateActivity (comsvcs.h)
Membuat aktivitas untuk melakukan pekerjaan batch sinkron atau asinkron yang dapat menggunakan layanan COM+ tanpa perlu membuat komponen COM+.
HRESULT CoCreateActivity(
[in] IUnknown *pIUnknown,
[in] REFIID riid,
[out] void **ppObj
);
[in] pIUnknown
Penunjuk ke antarmuka IUnknown objek, yang dibuat dari kelas CServiceConfig , yang berisi informasi konfigurasi untuk layanan yang akan digunakan dalam aktivitas yang dibuat oleh CoCreateActivity.
[in] riid
ID antarmuka yang akan dikembalikan melalui parameter ppObj . Parameter ini harus selalu IID_IServiceActivity sehingga pointer ke IServiceActivity dikembalikan.
[out] ppObj
Penunjuk ke antarmuka objek aktivitas. Objek aktivitas secara otomatis dibuat oleh panggilan ke CoCreateActivity.
Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan E_FAIL, serta nilai berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil diselesaikan. |
|
Konfigurasi perakitan berdampingan dari objek CServiceConfig tidak valid. |
|
Konfigurasi kumpulan utas objek CServiceConfig tidak valid. |
|
Konfigurasi pelacak objek CServiceConfig tidak valid. |
|
Pemanggil tidak memiliki izin akses untuk partisi COM+. |
CoCreateActivity membuat objek aktivitas yang digunakan untuk mengirimkan pekerjaan batch ke sistem COM+. Konteks yang terkait dengan aktivitas sepenuhnya ditentukan oleh objek CServiceConfig yang diteruskan melalui parameter pIUnknown .
CoCreateActivity memungkinkan aplikasi untuk menggunakan layanan COM+ dalam pekerjaan batch mereka tanpa perlu membuat komponen untuk menggunakan layanan tersebut. Selain mengurangi overhead dengan tidak memerlukan pembuatan komponen, menggunakan CoCreateActivity menyediakan lingkungan runtime yang lebih efisien karena memungkinkan lingkungan untuk mendukung konfigurasi layanan di seluruh aplikasi tanpa perlu mengakses informasi yang disimpan dalam database pendaftaran COM+ (RegDB).
Pekerjaan batch yang dikirimkan melalui CoCreateActivity dapat sinkron atau asinkron dan dapat berjalan di apartemen berulir tunggal (STA) atau apartemen multithreaded (MTA). Model threading yang digunakan ditentukan oleh antarmuka IServiceThreadPoolConfig dari objek CServiceConfig yang diteruskan melalui parameter pIUnknown .
CoCreateActivity mengembalikan penunjuk ke antarmuka IServiceActivity objek yang dibuat oleh panggilan ke CoCreateActivity. Dengan menggunakan metode IServiceActivity, Anda menentukan apakah pekerjaan batch dilakukan secara sinkron atau asinkron. Pekerjaan batch itu sendiri diimplementasikan melalui antarmuka IServiceCall .
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | comsvcs.h |
Pustaka | ComSvcs.lib |
DLL | ComSvcs.dll |