getprotobynumber 関数 (winsock2.h)

  • [アーティクル]

getprotobynumber 関数は、プロトコル番号に対応するプロトコル情報を取得します。

構文

protoent *WSAAPI getprotobynumber(
  [in] int number
);

パラメーター

[in] number

ホストのバイト順のプロトコル番号。

戻り値

エラーが発生しない場合、 getprotobynumber は 原始 構造体へのポインターを返します。 それ以外の場合は null ポインターを返し、 WSAGetLastError を呼び出すことで特定のエラー番号を取得できます。

エラー コード 意味
WSANOTINITIALIZED
 この関数を使用する前に、 WSAStartup 呼び出しが正常に行われる必要があります。
WSAENETDOWN
 ネットワーク サブシステムが失敗しました。
WSAHOST_NOT_FOUND
 信頼できる応答プロトコルが見つかりません。
WSATRY_AGAIN
 認証されていないプロトコルが見つからないか、サーバーの障害。
WSANO_RECOVERY
 回復不可能なエラー。プロトコル データベースにアクセスできません。
WSANO_DATA
 有効な名前。要求された型のデータ レコードはありません。
WSAEINPROGRESS
 ブロックしている Windows Sockets 1.1 呼び出しが進行中であるか、サービス プロバイダーがコールバック関数を処理しています。
WSAEINTR
 WSACancelBlockingCall を使用して、Windows Socket 1.1 の呼び出しをブロックしているが取り消されました。

注釈

この getprotobynumber 関数は、getprotobyname で前述したように、原始構造体へのポインターを返します。 構造体の内容は、指定されたプロトコル番号に対応します。

返されるポインターは、Windows ソケットによって割り当てられた構造体を指します。 アプリケーションは、この構造を変更したり、そのコンポーネントを解放したりしてはなりません。 さらに、この構造体のコピーはスレッドごとに 1 つだけ割り当てられるため、アプリケーションは、他の Windows ソケット関数呼び出しを発行する前に、必要な情報をコピーする必要があります。

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
ヘッダー winsock2.h (Winsock2.h を含む)
Library Ws2_32.lib
[DLL] Ws2_32.dll

こちらもご覧ください

WSAAsyncGetProtoByNumber

Winsock 関数

Winsock リファレンス

getprotobyname