Share via

Fungsi WSAGetServiceClassNameByClassIdA (winsock2.h)

  • Artikel

Fungsi WSAGetServiceClassNameByClassId mengambil nama layanan yang terkait dengan jenis yang ditentukan. Nama ini adalah nama layanan generik, seperti FTP atau SNA, dan bukan nama instans tertentu dari layanan tersebut.

Sintaks

INT WSAAPI WSAGetServiceClassNameByClassIdA(
  [in]      LPGUID  lpServiceClassId,
  [out]     LPSTR   lpszServiceClassName,
  [in, out] LPDWORD lpdwBufferLength
);

Parameter

[in] lpServiceClassId

Penunjuk ke GUID untuk kelas layanan.

[out] lpszServiceClassName

Penunjuk ke nama layanan.

[in, out] lpdwBufferLength

Pada input, panjang buffer yang dikembalikan oleh lpszServiceClassName, dalam karakter. Pada output, panjang nama layanan yang disalin ke dalam lpszServiceClassName, dalam karakter.

Nilai kembali

Fungsi WSAGetServiceClassNameByClassId mengembalikan nilai nol jika berhasil. Jika tidak, nilai SOCKET_ERROR dikembalikan, dan nomor kesalahan tertentu dapat diambil dengan memanggil WSAGetLastError.

Kode kesalahan Makna
WSA_INVALID_PARAMETER
 Parameter lpServiceClassId yang ditentukan tidak valid.
WSA_NOT_ENOUGH_MEMORY
 Memori tidak cukup untuk melakukan operasi.
WSAEACCES
 Rutinitas panggilan tidak memiliki hak istimewa yang memadai untuk mengakses informasi.
WSAEFAULT
 Buffer yang ditentukan yang diacu oleh lpszServiceClassName terlalu kecil. Berikan buffer yang lebih besar.
WSAENOBUFS
 Tidak ada ruang buffer yang tersedia.
WSAEOPNOTSUPP
 Operasi tidak didukung untuk jenis objek yang dirujuk. Kesalahan ini dikembalikan oleh beberapa penyedia namespace layanan yang tidak mendukung mendapatkan informasi kelas layanan.
WSANO_DATA
 lpServiceClassId 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 WSAGetServiceClassNameByClassId sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprocessor 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 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header winsock2.h
Pustaka Ws2_32.lib
DLL Ws2_32.dll

Lihat juga

Mulai WSA

Fungsi Winsock

Referensi Winsock