MIB_UDP6ROW_OWNER_MODULE 構造体 (udpmib.h)

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

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

構文

typedef struct _MIB_UDP6ROW_OWNER_MODULE {
  UCHAR         ucLocalAddr[16];
  DWORD         dwLocalScopeId;
  DWORD         dwLocalPort;
  DWORD         dwOwningPid;
  LARGE_INTEGER liCreateTimestamp;
  union {
    struct {
      int SpecificPortBind : 1;
    };
    int dwFlags;
  };
  ULONGLONG     OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE];
} MIB_UDP6ROW_OWNER_MODULE, *PMIB_UDP6ROW_OWNER_MODULE;

メンバー

ucLocalAddr[16]

種類: UCHAR[16]

ローカルコンピューター上の UDP エンドポイントの IPv6 アドレス。このメンバーは、ネットワークのバイト順に文字配列に格納されます。

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

dwLocalScopeId

型: DWORD

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

dwLocalPort

型: DWORD

ローカル UDP エンドポイントのポート番号。

dwOwningPid

型: DWORD

このエンドポイントのコンテキストバインドを発行したプロセスの PID。この値が 0 に設定されている場合、このエンドポイントの情報は使用できません。

liCreateTimestamp

種類: LARGE_INTEGER

このエンドポイントを作成したコンテキストバインド操作がいつ発生したのを示す FILETIME 構造体。

SpecificPortBind

型: int

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

dwFlags

型: int

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

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

種類: ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

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

注釈

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

ucLocalAddr メンバーは、ネットワークのバイト順に文字配列に格納されます。 Windows Vista 以降では、 RtlIpv6AddressToString 関数または RtlIpv6AddressToStringEx 関数を使用して、 ucLocalAddr メンバーの IPv6 アドレスを Windows ソケット DLL を読み込まずに文字列に変換できます。

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

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

MIB_UDP6TABLE_OWNER_MODULE構造体には、ローカルコンピューター上の IPv6 の UDP リスナーテーブルが含まれています。名前は、IETF によって発行された RFC 2454 のこのテーブルの定義に基づいています。詳細については、「http://www.ietf.org/rfc/rfc2454.txt」を参照してください。この表には、アドレスにバインドされている IPv6 の 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 を含む)