fungsi getservbyname (winsock.h)

  • Artikel

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
WSANOTINITIALISED
 Panggilan WSAStartup yang berhasil harus terjadi sebelum menggunakan fungsi ini.
WSAENETDOWN
 Subsistem jaringan gagal.
WSAHOST_NOT_FOUND
 Layanan Jawaban Otoritatif tidak ditemukan.
WSATRY_AGAIN
 Layanan nonautoritatif tidak ditemukan, atau kegagalan server.
WSANO_RECOVERY
 Kesalahan yang tidak dapat dipulihkan, database layanan tidak dapat diakses.
WSANO_DATA
 Nama yang valid, tidak ada catatan data dari jenis yang diminta.
WSAEINPROGRESS
 Pemblokiran panggilan Windows Sockets 1.1 sedang berlangsung, atau penyedia layanan masih memproses fungsi panggilan balik.
WSAEINTR
 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

Lihat juga

WSAAsyncGetServByName

Fungsi Winsock

Referensi Winsock

getservbyport