Fungsi SetServiceA (nspapi.h)
Fungsi SetService mendaftarkan atau menghapus dari registri layanan jaringan dalam satu atau beberapa namespace layanan. Fungsi ini juga dapat menambahkan atau menghapus jenis layanan jaringan dalam satu atau beberapa namespace layanan.
Sintaks
INT SetServiceA(
[in] DWORD dwNameSpace,
[in] DWORD dwOperation,
[in] DWORD dwFlags,
[in] LPSERVICE_INFOA lpServiceInfo,
[in, optional] LPSERVICE_ASYNC_INFO lpServiceAsyncInfo,
[out] LPDWORD lpdwStatusFlags
);
Parameter
[in] dwNameSpace
Namespace layanan, atau sekumpulan namespace default, di mana fungsi akan beroperasi.
Gunakan salah satu konstanta berikut untuk menentukan namespace.
[in] dwOperation
Operasi yang akan dilakukan fungsi. Gunakan salah satu nilai berikut untuk menentukan operasi:
Nilai | Makna |
---|---|
|
Daftarkan layanan jaringan dengan namespace layanan. Operasi ini dapat digunakan dengan bendera bit SERVICE_FLAG_DEFER dan SERVICE_FLAG_HARD. |
|
Hapus dari registri layanan jaringan dari namespace layanan. Operasi ini dapat digunakan dengan bendera bit SERVICE_FLAG_DEFER dan SERVICE_FLAG_HARD. |
|
Lakukan operasi apa pun yang dipanggil dengan bendera bit SERVICE_FLAG_DEFER diatur ke satu. |
|
Tambahkan jenis layanan ke namespace layanan.
Untuk operasi ini, gunakan anggota ServiceSpecificInfo dari struktur SERVICE_INFO yang ditujukkan oleh lpServiceInfo untuk meneruskan struktur SERVICE_TYPE_INFO_ABS . Anda juga harus mengatur anggota ServiceType dari struktur SERVICE_INFO . Anggota SERVICE_INFO lainnya diabaikan. |
|
Hapus jenis layanan, ditambahkan oleh panggilan sebelumnya yang menentukan operasi SERVICE_ADD_TYPE, dari namespace layanan. |
[in] dwFlags
Sekumpulan bendera bit yang memodifikasi operasi fungsi. Anda dapat mengatur satu atau beberapa bendera bit berikut:
[in] lpServiceInfo
Penunjuk ke struktur SERVICE_INFO yang berisi informasi tentang layanan jaringan atau jenis layanan.
[in, optional] lpServiceAsyncInfo
Disiapkan untuk penggunaan masa mendatang. Harus diatur ke NULL.
[out] lpdwStatusFlags
Sekumpulan bendera bit yang menerima informasi status fungsi. Bendera bit berikut didefinisikan:
Nilai | Makna |
---|---|
|
Satu atau beberapa penyedia namespace tidak berhasil melakukan operasi yang diminta. |
Nilai kembali
Jika fungsi gagal, nilai yang dikembalikan SOCKET_ERROR. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. GetLastError dapat mengembalikan nilai kesalahan yang diperluas berikut.
Kode kesalahan | Makna |
---|---|
|
Fungsi ini mencoba mendaftarkan layanan yang sudah terdaftar. |
Keterangan
Catatan
Header nspapi.h mendefinisikan SetService sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscessor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | nspapi.h |
Pustaka | Mswsock.lib |
DLL | Mswsock.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk