getprotobyname 函式 (winsock.h)

  • 發行項

getprotobyname 函式會擷取對應至通訊協定名稱的通訊協議資訊。

語法

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

參數

[in] name

Null 終止通訊協定名稱的指標。

傳回值

如果沒有發生錯誤， getprotobyname 會傳回 protoent 的指標。 否則，它會傳回 Null 指標，而且可以藉由呼叫 WSAGetLastError 來擷取特定的錯誤號碼。

錯誤碼 意義
WSANOTINITIALISED
 使用這個函式之前，必須先進行成功的 WSAStartup 呼叫。
WSAENETDOWN
 網路子系統失敗。
WSAHOST_NOT_FOUND
 找不到授權回應通訊協定。
WSATRY_AGAIN
 找不到非授權通訊協定，或伺服器失敗。
WSANO_RECOVERY
 無法復原的錯誤，無法存取通訊協議資料庫。
WSANO_DATA
 有效名稱，沒有要求類型的數據記錄。
WSAEINPROGRESS
 封鎖的 Windows Sockets 1.1 呼叫正在進行中，或服務提供者仍在處理回呼函式。
WSAEFAULT
 name 參數不是使用者位址空間的有效部分。
WSAEINTR
 封鎖的 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

另請參閱

WSAAsyncGetProtoByName

Winsock 函式

Winsock 參考

getprotobynumber