Bagikan melalui

Fungsi WSASetServiceA (winsock2.h)

  • Artikel

Fungsi WSASetService mendaftarkan atau menghapus dari registri instans layanan dalam satu atau beberapa namespace layanan.

Sintaksis

INT WSAAPI WSASetServiceA(
  [in] LPWSAQUERYSETA   lpqsRegInfo,
  [in] WSAESETSERVICEOP essoperation,
  [in] DWORD            dwControlFlags
);

Parameter

[in] lpqsRegInfo

Pointer ke informasi layanan untuk pendaftaran atau deregistrasi.

[in] essoperation

Nilai yang menentukan operasi yang diminta. Parameter ini dapat menjadi salah satu nilai dari jenis enumerasi WSAESETSERVICEOP yang ditentukan dalam file header Winsock2.h.

Nilai Arti
RNRSERVICE_REGISTER
 Daftarkan layanan. Untuk SAP, ini berarti mengirimkan siaran berkala. Ini adalah NOP untuk namespace DNS. Untuk penyimpanan data persisten, ini berarti memperbarui informasi alamat.
RNRSERVICE_DEREGISTER
 Hapus layanan dari registri. Untuk SAP, ini berarti berhenti mengirim siaran berkala. Ini adalah NOP untuk namespace DNS. Untuk penyimpanan data persisten, ini berarti menghapus informasi alamat.
RNRSERVICE_DELETE
 Hapus layanan dari nama dinamis dan ruang persisten. Untuk layanan yang diwakili oleh beberapa struktur CSADDR_INFO (menggunakan bendera SERVICE_MULTIPLE), hanya alamat yang ditentukan yang akan dihapus, dan ini harus cocok dengan struktur CSADDR_INFO yang sesuai yang ditentukan ketika layanan terdaftar.

[in] dwControlFlags

Nilai bendera penginstalan layanan yang lebih mengontrol operasi yang dilakukan fungsi WSASetService. Nilai yang mungkin untuk parameter ini didefinisikan dalam file header Winsock2.h.

Bendera Arti
SERVICE_MULTIPLE
 Mengontrol cakupan operasi. Ketika bendera ini tidak diatur, alamat layanan dikelola sebagai grup. Daftar atau penghapusan dari registri membatalkan semua alamat yang ada sebelum menambahkan set alamat yang diberikan. Saat diatur, tindakan hanya dilakukan pada set alamat yang diberikan. Register tidak membatalkan alamat yang ada dan penghapusan dari registri hanya membatalkan set alamat yang diberikan.

Mengembalikan nilai

Nilai pengembalian untuk WSASetService adalah nol jika operasi berhasil. Jika tidak, nilai SOCKET_ERROR dikembalikan, dan nomor kesalahan tertentu dapat diambil dengan memanggil WSAGetLastError.

Kode kesalahan Arti
WSAEACCES
Rutinitas panggilan tidak memiliki hak istimewa yang memadai untuk menginstal Layanan.
WSAEINVAL
 Satu atau beberapa parameter yang diperlukan tidak valid atau hilang.
WSANOTINITIALISED
 Ws2_32.dll belum diinisialisasi. Aplikasi harus terlebih dahulu memanggil WSAStartup sebelum memanggil fungsi Windows Sockets apa pun.
WSA_NOT_ENOUGH_MEMORY
 Memori tidak cukup untuk melakukan operasi.

Komentar

Fungsi WSASetService dapat digunakan untuk memengaruhi penyedia namespace tertentu, semua penyedia yang terkait dengan namespace tertentu, atau semua penyedia di semua namespace layanan.

Nilai yang tersedia untuk essOperation dan dwControlFlags menggabungkan untuk mengontrol operasi fungsi WSASetService seperti yang ditunjukkan dalam tabel berikut.

Operasi Bendera Layanan sudah ada Layanan tidak ada
RNRSERVICE_REGISTER Tidak Menimpa objek. Hanya menggunakan alamat yang ditentukan. Objek DIDAFTARKAN. Membuat objek baru. Hanya menggunakan alamat yang ditentukan. Objek TERDAFTAR.
RNRSERVICE_REGISTER SERVICE_MULTIPLE Memperbarui objek. Menambahkan alamat baru ke set yang sudah ada. Objek DIDAFTARKAN. Membuat objek baru. Menggunakan semua alamat yang ditentukan. Objek TERDAFTAR.
RNRSERVICE_DEREGISTER Tidak Menghapus semua alamat, tetapi tidak menghapus objek dari namespace. Objek dihapus dari registri. WSASERVICE_NOT_FOUND
RNRSERVICE_DEREGISTER SERVICE_MULTIPLE Memperbarui objek. Menghapus hanya alamat yang ditentukan. Hanya menandai objek sebagai DEREGISTERED jika tidak ada alamat yang ada. Tidak menghapus objek dari namespace layanan. WSASERVICE_NOT_FOUND
RNRSERVICE_DELETE Tidak Menghapus objek dari namespace layanan. WSASERVICE_NOT_FOUND
RNRSERVICE_DELETE SERVICE_MULTIPLE Menghapus hanya alamat yang ditentukan. Hanya menghapus objek dari namespace jika tidak ada alamat yang tersisa. WSASERVICE_NOT_FOUND
 

Layanan penerbitan ke direktori, seperti Layanan Direktori Aktif, dibatasi berdasarkan daftar kontrol akses (ACL). Untuk informasi selengkapnya, lihat Masalah Keamanan untuk Publikasi Layanan.

Ketika parameter dwControlFlags diatur ke SERVICE_MULTIPLE, aplikasi dapat mengelola alamatnya secara independen. Ini berguna ketika aplikasi ingin mengelola protokolnya satu per satu atau ketika layanan berada di lebih dari satu komputer. Misalnya, ketika layanan menggunakan lebih dari satu protokol, mungkin menemukan bahwa satu soket mendengarkan dibatalkan tetapi soket lainnya tetap beroperasi. Dalam hal ini, layanan dapat menghapus alamat yang dibatalkan dari registri tanpa memengaruhi alamat lain.

Ketika parameter dwControlFlags diatur ke SERVICE_MULTIPLE, aplikasi tidak boleh membiarkan alamat basi tetap ada di objek. Ini dapat terjadi jika aplikasi membatalkan tanpa mengeluarkan permintaan DEREGISTER. Ketika layanan mendaftar, layanan harus menyimpan alamatnya. Pada pemanggilan berikutnya, layanan harus secara eksplisit menghapus alamat lama ini dari registri sebelum mendaftarkan alamat baru.

Catatan Jika string karakter ANSI digunakan, ada kemungkinan bahwa data WSAQUERYSET dalam lpqsRegInfo mungkin tidak berisi hasil apa pun setelah fungsi ini kembali. Ini karena versi ANSI dari metode ini, WSASetServiceA, mengonversi data ANSI di WSAQUERYSET ke Unicode secara internal, tetapi tidak mengonversi hasilnya kembali ke ANSI. Ini terutama berdampak pada transportasi yang mengembalikan "handel catatan layanan" yang digunakan untuk mengidentifikasi rekaman secara unik. Untuk mengatasi masalah ini, aplikasi harus menggunakan data string Unicode di WSAQUERYSET saat memanggil fungsi ini.
 

Properti Layanan

Tabel berikut ini menjelaskan bagaimana data properti layanan diwakili dalam struktur WSAQUERYSET . Bidang berlabel sebagai (Opsional) bisa berisi penunjuk null.
Anggota WSAQUERYSET Deskripsi properti layanan
dwSize Harus diatur ke sizeof (WSAQUERYSET). Ini adalah mekanisme penerapan versi.
dwOutputFlags Tidak berlaku dan diabaikan.
lpszServiceInstanceName String yang dirujuk berisi nama instans layanan.
lpServiceClassId GUID yang sesuai dengan kelas layanan ini.
lpVersion (Opsional) Menyediakan nomor versi instans layanan.
lpszComment (Opsional) String komentar opsional.
dwNameSpace Lihat tabel berikut ini.
lpNSProviderId Lihat tabel berikut ini.
lpszContext (Opsional) Menentukan titik awal kueri dalam namespace hierarkis.
dwNumberOfProtocols Diabaikan.
lpafpProtocols Diabaikan.
lpszQueryString Diabaikan.
dwNumberOfCsAddrs Jumlah elemen dalam array struktur CSADDR_INFO yang dirujuk oleh lpcsaBuffer.
lpcsaBuffer Penunjuk ke array struktur CSADDR_INFO yang berisi alamat yang didengarkan layanan.
lpBlob (Opsional) Ini adalah penunjuk ke entitas khusus penyedia.
 

Seperti yang diilustrasikan dalam hal berikut, kombinasi dwNameSpace dan anggota lpNSProviderId menentukan bahwa penyedia namespace layanan terpengaruh oleh fungsi ini.

dwNameSpace lpNSProviderId Cakupan dampak
Diabaikan Non-null Penyedia ruang nama yang ditentukan.
Nama yang valid- pengidentifikasi spasi Nol Semua penyedia ruang nama yang mendukung namespace yang ditunjukkan.
NS_ALL Nol Semua penyedia ruang nama.
 

Windows Phone 8: Fungsi WSASetServiceW didukung untuk aplikasi Windows Phone Store di Windows Phone 8 dan yang lebih baru.

Windows 8.1 dan Windows Server 2012 R2: Fungsi WSASetServiceW didukung untuk aplikasi Windows Store pada Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.

Nota

Header winsock2.h mendefinisikan WSASetService sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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 8.1, Windows Vista [aplikasi desktop | Aplikasi UWP]
server minimum yang didukung Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Platform Target Windows
Header winsock2.h
Pustaka Ws2_32.lib
DLL Ws2_32.dll

Lihat juga

Bluetooth dan WSASetService

WSAGetLastError

WSAStartup

Winsock Functions

Referensi Winsock