fungsi getservbyport (winsock.h)

Artikel
08/27/2023

Fungsi getservbyport mengambil informasi layanan yang sesuai dengan port dan protokol.

Sintaks

servent * getservbyport(
  [in] int        port,
  [in] const char *proto
);

Parameter

[in] port

Port untuk layanan, dalam urutan byte jaringan.

[in] proto

Penunjuk opsional ke nama protokol. Jika ini null, getservbyport mengembalikan entri layanan pertama yang portnya cocok dengan s_port struktur servent . Jika tidak, getservbyport cocok dengan parameter port dan proto .

Mengembalikan nilai

Jika tidak ada kesalahan yang terjadi, getservbyport mengembalikan pointer 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 non-otoritatif 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	Panggilan Windows Sockets 1.1 yang diblokir sedang berlangsung, atau penyedia layanan masih memproses fungsi panggilan balik.
WSAEFAULT	Parameter proto bukan bagian yang valid dari ruang alamat pengguna.
WSAEINTR	Panggilan Windows Socket 1.1 pemblokiran dibatalkan melalui WSACancelBlockingCall.

Keterangan

Fungsi getservbyport mengembalikan pointer ke struktur servent seperti dalam fungsi getservbyname .

Struktur servent dialokasikan oleh 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

WSAAsyncGetServByPort

Fungsi Winsock

Referensi Winsock

getservbyname

Bagikan melalui