Fungsi WSAGetServiceClassNameByClassIdA (winsock2.h)
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 |
---|---|
Parameter lpServiceClassId yang ditentukan tidak valid. | |
Memori tidak cukup untuk melakukan operasi. | |
Rutinitas panggilan tidak memiliki hak istimewa yang memadai untuk mengakses informasi. | |
Buffer yang ditentukan yang diacu oleh lpszServiceClassName terlalu kecil. Berikan buffer yang lebih besar. | |
Tidak ada ruang buffer yang tersedia. | |
Operasi tidak didukung untuk jenis objek yang dirujuk. Kesalahan ini dikembalikan oleh beberapa penyedia namespace layanan yang tidak mendukung mendapatkan informasi kelas layanan. | |
lpServiceClassId valid, tetapi tidak ada data dari jenis yang diminta yang ditemukan. | |
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 |