IN_PKTINFO-Struktur (ws2ipdef.h)

Artikel
08/28/2023

Die in_pktinfo-Struktur wird zum Speichern empfangener Paketadresseninformationen verwendet und von Windows verwendet, um Informationen über empfangene Pakete zurückzugeben, und ermöglicht auch die Angabe der lokalen IPv4-Adresse, die zum Senden von Paketen verwendet werden soll.

Syntax

typedef struct in_pktinfo {
  IN_ADDR ipi_addr;
  ULONG   ipi_ifindex;
} IN_PKTINFO, *PIN_PKTINFO;

Member

ipi_addr

Die IPv4-Zieladresse aus dem IP-Header des empfangenen Pakets, wenn sie mit der funktion LPFN_WSARECVMSG (WSARecvMsg) verwendet wird. Die lokale IPv4-Quelladresse, die im IP-Header festgelegt werden soll, wenn sie mit der WSASendMsg-Funktion verwendet wird.

ipi_ifindex

Die Schnittstelle, auf der das Paket bei Verwendung mit der funktion LPFN_WSARECVMSG (WSARecvMsg) empfangen wurde. Die Schnittstelle, auf der das Paket gesendet werden soll, wenn es mit der WSASendMsg-Funktion verwendet wird.

Hinweise

Wenn die Option IP_PKTINFO Socket für einen Socket vom Typ SOCK_DGRAM oder SOCK_RAW festgelegt ist, enthält eines der von der funktion LPFN_WSARECVMSG (WSARecvMsg) zurückgegebenen Steuerelementdatenobjekte eine in_pktinfo Struktur, die zum Speichern empfangener Paketadresseninformationen verwendet wird.

In einem IPv4-Socket vom Typ SOCK_DGRAM oder SOCK_RAW kann eine Anwendung die lokale IP-Adresse angeben, die zum Senden mit der WSASendMsg-Funktion verwendet werden soll. Eines der Steuerelementdatenobjekte, die in der WSAMSG-Struktur an die WSASendMsg-Funktion übergeben werden, kann eine in_pktinfo-Struktur enthalten, die verwendet wird, um die lokale IPv4-Adresse anzugeben, die für das Senden verwendet werden soll.

Im Microsoft Windows Software Development Kit (SDK), das für Windows Vista und höher veröffentlicht wurde, wurde die organization von Headerdateien geändert, und die in_pktinfo-Struktur wird in der Ws2ipdef.h-Headerdatei definiert, die automatisch in der Headerdatei Ws2tcpip.h enthalten ist. Die Ws2ipdef.h-Headerdateien sollten niemals direkt verwendet werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	ws2ipdef.h (include Ws2tcpip.h)