MIB_UDPROW_OWNER_MODULE結構 (udpmib.h)

發行項
03/13/2024

MIB_UDPROW_OWNER_MODULE 結構包含本機計算機上的 IPv4 使用者數據報通訊協定 (UDP) 接聽程式數據表的專案。這個專案也包含任何可用的擁有權數據和進程標識碼 (PID) 發出 UDP 端點的系結函式呼叫。

語法

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 位址。

值為零表示 UDP 接聽程式願意接受與本機計算機相關聯之任何 IP 介面的數據報。

dwLocalPort

類型： DWORD

本機電腦上的 UDP 連接點埠號碼。此成員會以網路位元組順序儲存。

dwOwningPid

類型： DWORD

發出 UDP 端點之 bind 函式呼叫之進程的 PID。當 PID 無法使用時，這個成員會設定為 0。

liCreateTimestamp

類型： LARGE_INTEGER

FILETIME 結構，指出何時呼叫 UDP 端點的 bind 函式。

SpecificPortBind

類型： int

值，指出上一個內容系結作業中是否指定了特定埠。

dwFlags

類型： int

一組旗標。目前未使用此成員。

OwningModuleInfo[TCPIP_OWNING_MODULE_SIZE]

類型： ULONGLONG[TCPIP_OWNING_MODULE_SIZE]

包含擁有權資訊的不透明數據陣列。

備註

呼叫 GetExtendedUdpTable 時，會傳回MIB_UDPTABLE_OWNER_MODULE結構，並將 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 Sockets 或類似函式中的 ntohl 或 inet_ntoa 函式。在 Windows Vista 和更新版本上， RtlIpv4AddressToString 或 RtlIpv4AddressToStringEx 函式可用來將 dwLocalAddr 成員中的 IPv4 位址轉換為字串，而不載入 Windows Sockets DLL。

dwLocalPort 成員會依網路位元組順序排列。若要使用 dwLocalPort 成員，可能需要 Windows Sockets 或類似函式中的 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 軟體開發套件 (SDK) 上，頭檔的組織已變更。此結構定義於 Udpmib.h 頭檔中，而不是 在 Iprtrmib.h 頭檔中。請注意， Udpmib.h 頭檔會自動包含在 Iprtrmib.h 中，該檔案會自動包含在 Iphlpapi.h 頭檔中。不應該直接使用 Udpmib.h 和 Iprtrmib.h 頭檔。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008、Windows Server 2003 SP1 [僅限傳統型應用程式]
標頭	udpmib.h (包含 Iphlpapi.h)