Metode ICOMAdminCatalog2::CreateServiceForApplication (comadmin.h)

Artikel
08/22/2023

Mengonfigurasi aplikasi COM+ untuk dijalankan sebagai layanan Windows.

Sintaks

HRESULT CreateServiceForApplication(
  [in] BSTR         bstrApplicationIDOrName,
  [in] BSTR         bstrServiceName,
  [in] BSTR         bstrStartType,
  [in] BSTR         bstrErrorControl,
  [in] BSTR         bstrDependencies,
  [in] BSTR         bstrRunAs,
  [in] BSTR         bstrPassword,
  [in] VARIANT_BOOL bDesktopOk
);

Parameter

[in] bstrApplicationIDOrName

ID aplikasi atau nama aplikasi.

[in] bstrServiceName

Nama layanan aplikasi. Nama ini adalah nama internal yang digunakan oleh manajer kontrol layanan (SCM), bukan nama tampilan.

[in] bstrStartType

Kapan memulai layanan. Argumen yang valid adalah opsi parameter dwStartType dari fungsi CreateService . Argumen harus dalam tanda kutip. Berikut ini adalah argumen yang valid: SERVICE_BOOT_START, SERVICE_SYSTEM_START, SERVICE_AUTO_START, SERVICE_DEMAND_START, dan SERVICE_DISABLED.

[in] bstrErrorControl

Tingkat keparahan kesalahan jika layanan ini gagal dimulai selama startup. Kesalahan menentukan tindakan yang diambil oleh program startup jika kegagalan terjadi. Argumen yang valid adalah opsi parameter dwErrorControl dari fungsi CreateService . Argumen harus dalam tanda kutip. Berikut ini adalah argumen yang valid: SERVICE_ERROR_IGNORE, SERVICE_ERROR_NORMAL, SERVICE_ERROR_SEVERE, dan SERVICE_ERROR_CRITICAL.

[in] bstrDependencies

Daftar dependensi untuk layanan. Ada dua kemungkinan format untuk string: string standar yang dibatasi null, double-null-terminated (persis seperti yang didokumenkan untuk CreateService); atau daftar nama layanan yang ramah skrip yang dipisahkan oleh "" (karakter yang tidak valid untuk dimiliki dalam nama layanan). Layanan rpcss implisit dalam parameter ini dan tidak perlu ditentukan.

[in] bstrRunAs

Nama pengguna untuk menjalankan layanan ini sebagai. Jika parameter ini NULL, layanan akan berjalan sebagai Layanan Lokal.

[in] bstrPassword

Kata sandi untuk akun pengguna sistem. Parameter ini harus NULL jika layanan dikonfigurasi untuk dijalankan sebagai Layanan Lokal.

[in] bDesktopOk

Menunjukkan apakah layanan harus diizinkan untuk berinteraksi dengan desktop. Parameter ini hanya valid ketika layanan ditandai sebagai Layanan Lokal dan harus FALSE jika tidak.

Nilai kembali

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

Keterangan

Layanan yang dibuat oleh metode ini dapat dihapus menggunakan metode DeleteServiceForApplication .

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	comadmin.h

Lihat juga

ICOMAdminCatalog2

Bagikan melalui