Bagikan melalui

Fungsi SetServiceA (nspapi.h)

  • Artikel

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.

Note Fungsi SetService sudah usang. Fungsi yang dirinci dalam Resolusi Nama Protocol-Independent menyediakan fungsionalitas yang setara di Windows Sockets 2. Untuk kenyamanan pengembang Windows Sockets 1.1, materi referensinya adalah sebagai berikut.
 

Sintaksis

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

Nilai Arti
NS_DEFAULT
 Sekumpulan namespace default. Fungsi ini mengkueri setiap namespace dalam set ini. Kumpulan namespace default biasanya mencakup semua namespace layanan yang diinstal pada sistem. Namun, administrator sistem dapat mengecualikan namespace tertentu dari set. NS_DEFAULT adalah nilai yang harus digunakan sebagian besar aplikasi untuk dwNameSpace.
NS_DNS
 Sistem Nama Domain yang digunakan di Internet untuk mengatasi nama host.
NS_NDS
 Penyedia NetWare 4.
NS_NETBT
 NetBIOS melalui lapisan TCP/IP. Semua sistem Windows mendaftarkan nama komputer mereka dengan NetBIOS. Namespace ini digunakan untuk mengonversi nama komputer ke alamat IP yang menggunakan pendaftaran ini.
NS_SAP
 Protokol Iklan NetWare Service. Ini dapat mengakses bindery NetWare, jika sesuai. NS_SAP adalah namespace dinamis yang memungkinkan pendaftaran layanan.
NS_TCPIP_HOSTS
 Nilai pencarian dalam file <systemroot>\system32\drivers\etc\posts.
NS_TCPIP_LOCAL
 Mekanisme resolusi nama TCP/IP lokal, termasuk perbandingan dengan nama host lokal dan nilai pencarian dalam cache pemetaan host ke alamat IP.

[in] dwOperation

Operasi yang akan dilakukan fungsi. Gunakan salah satu nilai berikut untuk menentukan operasi:

Nilai Arti
SERVICE_REGISTER
 Daftarkan layanan jaringan dengan namespace layanan. Operasi ini dapat digunakan dengan bendera bit SERVICE_FLAG_DEFER dan SERVICE_FLAG_HARD.
SERVICE_DEREGISTER
 Hapus dari registri layanan jaringan dari namespace layanan. Operasi ini dapat digunakan dengan bendera bit SERVICE_FLAG_DEFER dan SERVICE_FLAG_HARD.
SERVICE_FLUSH
 Lakukan operasi apa pun yang dipanggil dengan bendera bit SERVICE_FLAG_DEFER diatur ke satu.
SERVICE_ADD_TYPE
 Tambahkan jenis layanan ke namespace layanan.

Untuk operasi ini, gunakan ServiceSpecificInfo anggota struktur SERVICE_INFO yang ditunjukkan oleh lpServiceInfo untuk melewati struktur SERVICE_TYPE_INFO_ABS. Anda juga harus mengatur ServiceType anggota struktur SERVICE_INFO. Anggota SERVICE_INFO lainnya diabaikan.
SERVICE_DELETE_TYPE
 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:

Nilai Arti
SERVICE_FLAG_DEFER
 Bendera bit ini hanya valid jika operasi SERVICE_REGISTER atau SERVICE_DEREGISTER.

Jika bendera bit ini adalah satu, dan valid, penyedia namespace harus menunggak operasi pendaftaran atau deregistrasi hingga operasi SERVICE_FLUSH diminta.
SERVICE_FLAG_HARD
 Bendera bit ini hanya valid jika operasi SERVICE_REGISTER atau SERVICE_DEREGISTER.

Jika bendera bit ini adalah satu, dan valid, penyedia namespace memperbarui informasi penyimpanan persisten yang relevan saat operasi dilakukan.

Misalnya: Jika operasi melibatkan deregistrasi di namespace layanan yang menggunakan penyimpanan persisten, penyedia namespace akan menghapus informasi penyimpanan persisten yang relevan.

[in] lpServiceInfo

Penunjuk ke struktur SERVICE_INFO yang berisi informasi tentang layanan jaringan atau jenis layanan.

[in, optional] lpServiceAsyncInfo

Dicadangkan untuk digunakan di masa mendatang. Harus diatur keNULL .

[out] lpdwStatusFlags

Sekumpulan bendera bit yang menerima informasi status fungsi. Bendera bit berikut didefinisikan:

Nilai Arti
SET_SERVICE_ PARTIAL_SUCCESS
 Satu atau beberapa penyedia namespace tidak berhasil melakukan operasi yang diminta.

Mengembalikan nilai

Jika fungsi gagal, nilai yang dikembalikan adalah SOCKET_ERROR. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError. GetLastError dapat mengembalikan nilai kesalahan yang diperluas berikut.

Kode kesalahan Arti
TERDAFTAR ERROR_ALREADY_
 Fungsi ini mencoba mendaftarkan layanan yang sudah terdaftar.

Komentar

Nota

Header nspapi.h mendefinisikan SetService sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

Syarat Nilai
klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Platform Target Windows
Header nspapi.h
Pustaka Mswsock.lib
DLL Mswsock.dll

Lihat juga

GetService

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

Winsock Functions

Referensi Winsock