GetAcceptExSockaddrs-Funktion (mswsock.h)

Artikel
02/29/2024

Die GetAcceptExSockaddrs-Funktion analysiert die Daten, die aus einem Aufruf der AcceptEx-Funktion abgerufen wurden, und übergibt die lokalen und Remoteadressen an eine Sockaddr-Struktur .

Hinweis Diese Funktion ist eine Microsoft-spezifische Erweiterung der Windows Sockets-Spezifikation.

Syntax

void GetAcceptExSockaddrs(
  [in]  PVOID    lpOutputBuffer,
  [in]  DWORD    dwReceiveDataLength,
  [in]  DWORD    dwLocalAddressLength,
  [in]  DWORD    dwRemoteAddressLength,
  [out] sockaddr **LocalSockaddr,
  [out] LPINT    LocalSockaddrLength,
  [out] sockaddr **RemoteSockaddr,
  [out] LPINT    RemoteSockaddrLength
);

Parameter

[in] lpOutputBuffer

Ein Zeiger auf einen Puffer, der den ersten Datenblock empfängt, der für eine Verbindung gesendet wird, die sich aus einem AcceptEx-Aufruf ergibt. Muss derselbe lpOutputBuffer-Parameter sein, der an die AcceptEx-Funktion übergeben wurde.

[in] dwReceiveDataLength

Die Anzahl der Bytes im Puffer, die für den Empfang der ersten Daten verwendet werden. Dieser Wert muss dem dwReceiveDataLength-Parameter entsprechen, der an die AcceptEx-Funktion übergeben wurde.

[in] dwLocalAddressLength

Die Anzahl der für die lokalen Adressinformationen reservierten Bytes. Dieser Wert muss dem dwLocalAddressLength-Parameter entsprechen, der an die AcceptEx-Funktion übergeben wurde.

[in] dwRemoteAddressLength

Die Anzahl der für die Remoteadresseninformationen reservierten Bytes. Dieser Wert muss gleich dem dwRemoteAddressLength-Parameter sein, der an die AcceptEx-Funktion übergeben wurde.

[out] LocalSockaddr

Ein Zeiger auf die sockaddr-Struktur , die die lokale Adresse der Verbindung empfängt (die gleichen Informationen, die von der getockname-Funktion zurückgegeben würden). Dieser Parameter muss angegeben werden.

[out] LocalSockaddrLength

Die Größe der lokalen Adresse in Bytes. Dieser Parameter muss angegeben werden.

[out] RemoteSockaddr

Ein Zeiger auf die sockaddr-Struktur , die die Remoteadresse der Verbindung empfängt (die gleichen Informationen, die von der getpeername-Funktion zurückgegeben würden). Dieser Parameter muss angegeben werden.

[out] RemoteSockaddrLength

Die Größe der lokalen Adresse in Bytes. Dieser Parameter muss angegeben werden.

Rückgabewert

Keine

Bemerkungen

Die GetAcceptExSockaddrs-Funktion wird ausschließlich mit der AcceptEx-Funktion verwendet, um die ersten Vom Socket empfangenen Daten in lokalen und Remoteadressen zu analysieren. Die AcceptEx-Funktion gibt lokale Und Remoteadresseninformationen in einem internen Format zurück. Anwendungsentwickler müssen die GetAcceptExSockaddrs-Funktion verwenden, wenn die sockaddr-Strukturen erforderlich sind, die die lokalen oder Remoteadressen enthalten.

Hinweis Der Funktionszeiger für die GetAcceptExSockaddrs-Funktion muss zur Laufzeit abgerufen werden, indem die WSAIoctl-Funktion mit dem angegebenen SIO_GET_EXTENSION_FUNCTION_POINTER opcode aufgerufen wird. Der an die WSAIoctl-Funktion übergebene Eingabepuffer muss WSAID_GETACCEPTEXSOCKADDRS enthalten, einen global eindeutigen Bezeichner (GUID), dessen Wert die Erweiterungsfunktion GetAcceptExSockaddrs identifiziert. Bei Erfolg enthält die von der WSAIoctl-Funktion zurückgegebene Ausgabe einen Zeiger auf die GetAcceptExSockaddrs-Funktion . Die WSAID_GETACCEPTEXSOCKADDRS GUID wird in der Headerdatei "Mswsock.h " definiert.

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps auf Windows Phone 8 und höher unterstützt.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1, Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mswsock.h (include Mswsock.h)
Bibliothek	Mswsock.lib
DLL	Mswsock.dll