Metode IUpdateServiceManager2::AddService2 (wuapi.h)

Artikel
08/28/2023

Mendaftarkan layanan dengan agen Windows Update (WUA) tanpa memerlukan file kabinet otorisasi (.cab). Metode ini juga mengembalikan pointer ke antarmuka IUpdateServiceRegistration .

Sintaks

HRESULT AddService2(
  [in]  BSTR                       serviceID,
  [in]  LONG                       flags,
  [in]  BSTR                       authorizationCabPath,
  [out] IUpdateServiceRegistration **retval
);

Parameter

[in] serviceID

Pengidentifikasi untuk layanan yang akan didaftarkan.

[in] flags

Kombinasi nilai AddServiceFlag yang digabungkan dengan menggunakan operasi OR bitwise. Nilai yang dihasilkan menentukan opsi untuk pendaftaran layanan. Untuk informasi selengkapnya, lihat Komentar.

[in] authorizationCabPath

Jalur file kabinet lokal yang ditandatangani Microsoft (.cab) yang memiliki informasi yang diperlukan untuk pendaftaran layanan. Jika kosong, agen pembaruan mencari file kabinet otorisasi (.cab) selama pendaftaran layanan saat koneksi jaringan tersedia.

[out] retval

Penunjuk ke antarmuka IUpdateServiceRegistration yang mewakili layanan tambahan.

Mengembalikan nilai

Mengembalikan S_OK jika berhasil. Jika tidak, mengembalikan kode kesalahan COM atau Windows.

Metode ini juga dapat mengembalikan kode kesalahan berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Nilai parameter tidak valid.
E_ACCESSDENIED	Metode ini tidak dapat dipanggil dari komputer jarak jauh jika parameter authorizationCabPath diatur ke string null.
WU_E_DS_SERVICEEXPIRED	File kabinet otorisasi (.cab) telah kedaluwarsa.
WU_E_DS_INVALIDOPERATION	Status Updates Otomatis tidak dapat diubah.

Keterangan

Metode ini dapat mengembalikan kode kesalahan jaringan ketika bendera asfAllowOnlineRegistration ditentukan.

Parameter authorizationCabPath bersifat opsional untuk metode ini. Jika parameter authorizationCabPath tidak ditentukan, parameter tersebut akan diambil dari server Windows Update.

Metode ini mengembalikan E_INVALIDARG jika bendera asfAllowOnlineRegistration atau asfAllowPendingRegistration ditentukan dan jika nilai parameter authorizationCabPath bukan string kosong.

Metode ini mengembalikan WU_E_DS_INVALIDOPERATION jika perubahan yang diminta dalam status Updates Otomatis bertentangan dengan spesifikasi dalam file kabinet otorisasi (.cab) ketika bendera asfRegisterServiceWithAU ditentukan. Kesalahan dikembalikan oleh fungsi WinVerifyTrust jika file kabinet otorisasi belum ditandatangani.

Agen pembaruan dan AddService2 berperilaku dengan cara berikut tergantung pada nilai AddServiceFlag yang Anda tentukan dalam parameter bendera :

Jika Anda menentukan asfAllowOnlineRegistration tanpa asfAllowPendingRegistration, agen pembaruan segera mencoba online untuk mendaftarkan layanan. AddService2 mengembalikan nilai HRESULT yang mencerminkan keberhasilan atau kegagalan pendaftaran. Jika pendaftaran gagal, agen pembaruan tidak melakukan upaya di masa mendatang untuk mendaftarkan layanan.
Jika Anda menentukan asfAllowPendingRegistration tanpa asfAllowOnlineRegistration, agen pembaruan tidak segera mendaftarkan layanan. AddService2 mengembalikan S_OK untuk menunjukkan bahwa agen pembaruan akan mencoba mendaftarkan layanan di lain waktu, yang tidak menjamin bahwa pendaftaran pada akhirnya akan berhasil.
Jika Anda menentukan asfAllowPendingRegistration dan asfAllowOnlineRegistration bersama-sama, agen pembaruan segera mencoba online untuk mendaftarkan layanan. AddService2 mengembalikan S_OK jika pendaftaran berhasil. AddService2 mengembalikan nilai HRESULT kegagalan jika pendaftaran gagal, tetapi agen pembaruan masih mencoba mendaftarkan layanan di lain waktu.
Jika Anda menentukan asfAllowPendingRegistration, asfAllowOnlineRegistration, atau keduanya, tentukan juga NULL untuk parameter authorizationCabPath .
Jika Anda tidak menentukan asfAllowPendingRegistration maupun asfAllowOnlineRegistration (dengan kata lain, jika bendera adalah nol atau asfRegisterServiceWithAU), Anda harus menentukan jalur non-NULL dalam parameter authorizationCabPath. Dalam mode ini, AddService2 memproses file kabinet (.cab) dan mendaftarkan layanan dengan cara yang sama seperti IUpdateServiceManager::AddService.
Jika Anda menentukan asfRegisterServiceWithAU, perubahan ke layanan Updates Otomatis default tidak terjadi (dan tidak tercermin dalam antarmuka pengguna Windows Update) hingga pendaftaran layanan berhasil. Ini berarti bahwa jika pendaftaran berhasil segera (karena Anda menentukan asfAllowPendingRegistration atau menyediakan file kabinet (.cab)), perubahan layanan Updates Otomatis juga segera terjadi. Jika pendaftaran tidak berhasil sampai nanti (karena Anda menentukan asfAllowPendingRegistration), perubahan layanan Updates Otomatis tidak terjadi kecuali pendaftaran layanan yang tertunda akhirnya berhasil.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional dengan SP3 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003, Windows 2000 Server dengan SP3 [hanya aplikasi desktop]
Target Platform	Windows
Header	wuapi.h
Pustaka	Wuguid.lib
DLL	Wuapi.dll

Lihat juga

IUpdateServiceManager2

Share via