getprotobyname 函式 (winsock.h)
getprotobyname 函式會擷取對應至通訊協定名稱的通訊協議資訊。
語法
protoent * getprotobyname(
[in] const char *name
);
參數
[in] name
Null 終止通訊協定名稱的指標。
傳回值
如果沒有發生錯誤， getprotobyname 會傳回 protoent 的指標。 否則，它會傳回 Null 指標，而且可以藉由呼叫 WSAGetLastError 來擷取特定的錯誤號碼。
| 錯誤碼 | 意義 |
|---|---|
| 使用這個函式之前，必須先進行成功的 WSAStartup 呼叫。 | |
| 網路子系統失敗。 | |
| 找不到授權回應通訊協定。 | |
| 找不到非授權通訊協定，或伺服器失敗。 | |
| 無法復原的錯誤，無法存取通訊協議資料庫。 | |
| 有效名稱，沒有要求類型的數據記錄。 | |
| 封鎖的 Windows Sockets 1.1 呼叫正在進行中，或服務提供者仍在處理回呼函式。 | |
| name 參數不是使用者位址空間的有效部分。 | |
| 封鎖的 Windows Socket 1.1 呼叫已透過 WSACancelBlockingCall 取消。 |
備註
getprotobyname 函式會傳回 protoent 結構的指標，其中包含名稱 (s) 和通訊協定編號，這些名稱會對應至 name 參數中指定的通訊協定。 所有字串都是以 Null 結尾。 Protoent 結構是由 Windows Sockets 連結庫所配置。 應用程式絕對不能嘗試修改此結構，或釋放其任何元件。 此外，如同 hostent，每個線程只會配置此結構的一個複本，因此應用程式應該先複製它所需的任何資訊，再發出任何其他 Windows Sockets 函數調用。
Windows Phone 8：Windows Phone 8 和更新版本上 Windows Phone 市集應用程式支援此函式。
Windows 8.1 和 Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更新版本上的 Windows 市集應用程式支援此函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8.1、Windows Vista [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | winsock.h (包含 Winsock2.h) |
| 程式庫 | Ws2_32.lib |
| Dll | Ws2_32.dll |