Fungsi CoCreateActivity (comsvcs.h)

Artikel
08/22/2023

Membuat aktivitas untuk melakukan pekerjaan batch sinkron atau asinkron yang dapat menggunakan layanan COM+ tanpa perlu membuat komponen COM+.

Sintaks

HRESULT CoCreateActivity(
  [in]  IUnknown *pIUnknown,
  [in]  REFIID   riid,
  [out] void     **ppObj
);

Parameter

[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.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_INVALIDARG, E_OUTOFMEMORY, dan E_FAIL, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
CO_E_SXS_CONFIG	Konfigurasi perakitan berdampingan dari objek CServiceConfig tidak valid.
CO_E_THREADPOOL_CONFIG	Konfigurasi kumpulan utas objek CServiceConfig tidak valid.
CO_E_TRACKER_CONFIG	Konfigurasi pelacak objek CServiceConfig tidak valid.
COMADMIN_E_PARTITION_ACCESSDENIED	Pemanggil tidak memiliki izin akses untuk partisi COM+.

Keterangan

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

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