fungsi getprotobynumber (winsock.h)

Fungsi getprotobynumber mengambil informasi protokol yang sesuai dengan nomor protokol.

Sintaks

protoent * getprotobynumber(
  int proto
);

Parameter

proto

TBD

Nilai kembali

Jika tidak ada kesalahan yang terjadi, getprotobynumber mengembalikan penunjuk ke struktur protoent . 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	Protokol jawaban otoritatif tidak ditemukan.
WSATRY_AGAIN	Protokol nonautoritatif tidak ditemukan, atau kegagalan server.
WSANO_RECOVERY	Kesalahan yang tidak dapat dipulihkan, database protokol 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 getprotobynumber ini mengembalikan penunjuk ke struktur protoent seperti yang dijelaskan sebelumnya dalam getprotobyname. Isi struktur sesuai dengan nomor protokol yang diberikan.

Penunjuk yang dikembalikan menunjuk ke struktur yang 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

WSAAsyncGetProtoByNumber

Fungsi Winsock

Referensi Winsock

getprotobyname