fungsi getservbyname (winsock.h)
Fungsi getservbyname mengambil informasi layanan yang sesuai dengan nama layanan dan protokol.
Sintaks
servent * getservbyname(
[in] const char *name,
[in] const char *proto
);
Parameter
[in] name
Penunjuk ke nama layanan yang dihentikan null.
[in] proto
Penunjuk ke nama protokol yang dihentikan null. Jika pointer ini NULL, fungsi getservbyname mengembalikan entri layanan pertama di mana nama cocok dengan anggota s_name struktur servent atau anggota s_aliases struktur servent . Jika tidak, getservbyname cocok dengan nama dan proto.
Mengembalikan nilai
Jika tidak ada kesalahan yang terjadi, getservbyname mengembalikan penunjuk ke struktur servent . Jika tidak, ia mengembalikan penunjuk null dan nomor kesalahan tertentu dapat diambil dengan memanggil WSAGetLastError.
Kode kesalahan | Makna |
---|---|
Panggilan WSAStartup yang berhasil harus terjadi sebelum menggunakan fungsi ini. | |
Subsistem jaringan gagal. | |
Layanan Jawaban Otoritatif tidak ditemukan. | |
Layanan nonautoritatif tidak ditemukan, atau kegagalan server. | |
Kesalahan yang tidak dapat dipulihkan, database layanan tidak dapat diakses. | |
Nama yang valid, tidak ada catatan data dari jenis yang diminta. | |
Pemblokiran panggilan Windows Sockets 1.1 sedang berlangsung, atau penyedia layanan masih memproses fungsi panggilan balik. | |
Panggilan Windows Socket 1.1 pemblokiran dibatalkan melalui WSACancelBlockingCall. |
Keterangan
Fungsi getservbyname mengembalikan penunjuk ke struktur servent yang berisi nama dan nomor layanan yang cocok dengan string dalam parameter nama . Semua string dihentikan null.
Penunjuk yang dikembalikan menunjuk ke struktur servent yang dialokasikan oleh pustaka Windows Sockets. Aplikasi tidak boleh mencoba memodifikasi struktur ini atau membebaskan salah satu komponennya. Selain itu, hanya satu salinan struktur ini yang dialokasikan per utas, sehingga aplikasi harus menyalin informasi apa pun yang dibutuhkan sebelum mengeluarkan panggilan fungsi Windows Sockets lainnya.
Windows Phone 8: Fungsi ini didukung untuk aplikasi Windows Phone Store di Windows Phone 8 dan yang lebih baru.
Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.
Persyaratan
Persyaratan | 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] |
Target Platform | Windows |
Header | winsock.h (termasuk Winsock2.h) |
Pustaka | Ws2_32.lib |
DLL | Ws2_32.dll |