MIB_UDPROW_OWNER_MODULE 構造体 (udpmib.h)

[アーティクル]
08/26/2023

MIB_UDPROW_OWNER_MODULE構造体には、ローカルコンピューター上の IPv4 ユーザーデータグラムプロトコル (UDP) リスナーテーブルからのエントリが含まれています。このエントリには、使用可能な所有権データと、UDP エンドポイントのバインド関数の呼び出しを発行したプロセス ID (PID) も含まれます。

構文

typedef struct _MIB_UDPROW_OWNER_MODULE {
  DWORD         dwLocalAddr;
  DWORD         dwLocalPort;
  DWORD         dwOwningPid;
  LARGE_INTEGER liCreateTimestamp;
  union {
    struct {
      int SpecificPortBind : 1;
    };
    int dwFlags;
  };
  ULONGLONG     OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_UDPROW_OWNER_MODULE, *PMIB_UDPROW_OWNER_MODULE;

メンバー

dwLocalAddr

型: DWORD

ローカルコンピューター上の UDP エンドポイントの IPv4 アドレス。

値 0 は、ローカルコンピューターに関連付けられている IP インターフェイスのデータグラムを受け入れる UDP リスナーを示します。

dwLocalPort

型: DWORD

ローカルコンピューター上の UDP エンドポイントのポート番号。このメンバーは、ネットワークのバイト順に格納されます。

dwOwningPid

型: DWORD

UDP エンドポイントのバインド関数の呼び出しを発行したプロセスの PID。 PID が使用できない場合、このメンバーは 0 に設定されます。

liCreateTimestamp

種類: LARGE_INTEGER

UDP エンドポイントのバインド関数の呼び出しが発生したタイミングを示す FILETIME 構造体。

SpecificPortBind

型: int

最後のコンテキストバインド操作で特定のポートが指定されたかどうかを示す値。

dwFlags

型: int

フラグのセット。このメンバーは現在使用されていません。

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

種類: ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

所有権情報を含む不透明なデータの配列。

注釈

MIB_UDPTABLE_OWNER_MODULE構造体は、GetExtendedUdpTable の呼び出しによって返され、TableClass パラメーターは UDP_TABLE_CLASS 列挙からUDP_TABLE_OWNER_MODULEに設定され、ulAf パラメーターは AF_INET に設定されます。 MIB_UDPTABLE_OWNER_MODULE構造体には、MIB_UDPROW_OWNER_MODULE構造体の配列が含まれています。

dwLocalAddr メンバーは、in_addr構造体と同じ形式で DWORD として格納されます。 dwLocalAddr メンバーを使用するには、Windows ソケットまたは同様の関数の ntohl またはinet_ntoa関数が必要になる場合があります。 Windows Vista 以降では、 RtlIpv4AddressToString 関数または RtlIpv4AddressToStringEx 関数を使用して、 dwLocalAddr メンバーの IPv4 アドレスを Windows ソケット DLL を読み込まずに文字列に変換できます。

dwLocalPort メンバーはネットワークバイト順です。 dwLocalPort メンバーを使用するには、Windows ソケットまたは同様の関数の ntohs またはinet_ntoa関数が必要になる場合があります。

MIB_UDPTABLE_OWNER_MODULE構造体には、ローカルコンピューター上の IPv4 の UDP リスナーテーブルが含まれています。名前は、IETF によって公開された RFC 1213 のこのテーブルの定義に基づいています。詳細については、「http://www.ietf.org/rfc/rfc1213.txt」を参照してください。このテーブルには、アドレスにバインドされている IPv4 の UDP エンドポイントが含まれています。アプリケーションは UDP ソケットを作成し、UDP データグラムを送信する唯一の目的のためにアドレスにバインドでき、このソケット (リスナーとして機能) を使用してパケットを受信する意図はありません。

Windows Vista 以降用にリリースされた Microsoft Windows ソフトウェア開発キット (Windows SDK) (SDK) では、ヘッダーファイルのorganizationが変更されました。この構造体は、Iprtrmib.h ヘッダーファイルではなく、Udpmib.h ヘッダーファイルで定義されます。 Udpmib.h ヘッダーファイルは、Iphlpapi.h ヘッダーファイルに自動的に含まれる Iprtrmib.h に自動的に含まれることに注意してください。 Udpmib.h および Iprtrmib.h ヘッダーファイルを直接使用しないでください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista、WINDOWS XP と SP2 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008、Windows Server 2003 SP1 [デスクトップアプリのみ]
Header	udpmib.h (Iphlpapi.h を含む)