Fungsi WSAInstallServiceClassA (winsock2.h)

Artikel
08/27/2023

Fungsi WSAInstallServiceClass mendaftarkan skema kelas layanan dalam namespace layanan. Skema ini mencakup nama kelas, pengidentifikasi kelas, dan informasi khusus namespace apa pun yang umum untuk semua instans layanan, seperti pengidentifikasi SAP atau pengidentifikasi objek.

Sintaks

INT WSAAPI WSAInstallServiceClassA(
  [in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);

Parameter

[in] lpServiceClassInfo

Kelas layanan ke informasi pemetaan jenis spesifik namespace layanan. Beberapa pemetaan dapat ditangani pada satu waktu.

Lihat bagian Struktur Data Kelas Layanan untuk deskripsi struktur data terkait.

Nilai kembali

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

Kode kesalahan	Makna
WSA_INVALID_PARAMETER	Penyedia namespace tidak dapat menyediakan informasi kelas yang diminta.
WSA_NOT_ENOUGH_MEMORY	Memori tidak cukup untuk melakukan operasi.
WSAEACCES	Fungsi panggilan tidak memiliki hak istimewa yang memadai untuk menginstal layanan.
WSAEALREADY	Informasi kelas layanan telah didaftarkan untuk pengidentifikasi kelas layanan ini. Untuk memodifikasi informasi kelas layanan, pertama-tama gunakan WSARemoveServiceClass, lalu instal ulang dengan data informasi kelas yang diperbarui.
WSAEINVAL	Informasi kelas layanan tidak valid atau tidak terstruktur dengan benar. Kesalahan ini dikembalikan jika parameter lpServiceClassInfo adalah NULL.
WSAEOPNOTSUPP	Operasi tidak didukung. Kesalahan ini dikembalikan jika penyedia namespace tidak menerapkan fungsi ini.
WSANO_DATA	Nama yang diminta valid, tetapi tidak ada data dari jenis yang diminta yang ditemukan.
WSANOTINITIALISED	WS2_32.DLL belum diinisialisasi. Aplikasi harus terlebih dahulu memanggil WSAStartup sebelum memanggil fungsi Windows Sockets apa pun.

Keterangan

Catatan

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


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winsock2.h
Pustaka	Ws2_32.lib
DLL	Ws2_32.dll