Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |