fungsi getprotobyname (winsock.h)

Fungsi getprotobyname mengambil informasi protokol yang sesuai dengan nama protokol.

Sintaks

protoent * getprotobyname(
  [in] const char *name
);

Parameter

[in] name

Penunjuk ke nama protokol yang dihentikan null.

Mengembalikan nilai

Jika tidak ada kesalahan yang terjadi, getprotobyname mengembalikan penunjuk ke 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.
WSAEFAULT	Parameter nama bukan bagian yang valid dari ruang alamat pengguna.
WSAEINTR	Panggilan Windows Socket 1.1 pemblokiran dibatalkan melalui WSACancelBlockingCall.

Keterangan

Fungsi getprotobyname mengembalikan penunjuk ke struktur protoent yang berisi nama dan nomor protokol yang sesuai dengan protokol yang ditentukan dalam parameter nama . Semua string dihentikan null. Struktur protoent dialokasikan oleh pustaka Windows Sockets. Aplikasi tidak boleh mencoba memodifikasi struktur ini atau membebaskan salah satu komponennya. Selain itu, seperti hostent, 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

WSAAsyncGetProtoByName

Fungsi Winsock

Referensi Winsock

getprotobynumber