GetAcceptExSockaddrs, fonction (winsock.h)

Article
08/27/2023

La fonction GetAcceptExSockaddrs analyse les données obtenues à partir d’un appel à la fonction AcceptEx et transmet les adresses locales et distantes à une structure sockaddr .

Note Cette fonction est une extension spécifique à Microsoft de la spécification des sockets Windows.

Syntaxe

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
);

Paramètres

[in] lpOutputBuffer

Pointeur vers une mémoire tampon qui reçoit le premier bloc de données envoyé sur une connexion résultant d’un appel AcceptEx . Doit être le même paramètre lpOutputBuffer qui a été passé à la fonction AcceptEx .

[in] dwReceiveDataLength

Nombre d’octets dans la mémoire tampon utilisée pour recevoir les premières données. Cette valeur doit être égale au paramètre dwReceiveDataLength qui a été passé à la fonction AcceptEx .

[in] dwLocalAddressLength

Nombre d’octets réservés aux informations d’adresse locale. Cette valeur doit être égale au paramètre dwLocalAddressLength qui a été passé à la fonction AcceptEx .

[in] dwRemoteAddressLength

Nombre d’octets réservés aux informations d’adresse distante. Cette valeur doit être égale au paramètre dwRemoteAddressLength qui a été passé à la fonction AcceptEx .

[out] LocalSockaddr

Pointeur vers la structure sockaddr qui reçoit l’adresse locale de la connexion (les mêmes informations que celles qui seraient retournées par la fonction getsockname ). Ce paramètre doit être spécifié.

[out] LocalSockaddrLength

Taille, en octets, de l’adresse locale. Ce paramètre doit être spécifié.

[out] RemoteSockaddr

Pointeur vers la structure sockaddr qui reçoit l’adresse distante de la connexion (les mêmes informations qui seraient retournées par la fonction getpeername ). Ce paramètre doit être spécifié.

[out] RemoteSockaddrLength

Taille, en octets, de l’adresse locale. Ce paramètre doit être spécifié.

Valeur de retour

None

Remarques

La fonction GetAcceptExSockaddrs est utilisée exclusivement avec la fonction AcceptEx pour analyser les premières données que le socket reçoit en adresses locales et distantes. La fonction AcceptEx retourne les informations d’adresse locale et distante dans un format interne. Les développeurs d’applications doivent utiliser la fonction GetAcceptExSockaddrs si les structures sockaddr contenant les adresses locales ou distantes sont nécessaires.

Note Le pointeur de fonction pour la fonction GetAcceptExSockaddrs doit être obtenu au moment de l’exécution en effectuant un appel à la fonction WSAIoctl avec le SIO_GET_EXTENSION_FUNCTION_POINTER opcode spécifié. La mémoire tampon d’entrée passée à la fonction WSAIoctl doit contenir WSAID_GETACCEPTEXSOCKADDRS, un identificateur global unique (GUID) dont la valeur identifie la fonction d’extension GetAcceptExSockaddrs . En cas de réussite, la sortie retournée par la fonction WSAIoctl contient un pointeur vers la fonction GetAcceptExSockaddrs . Le GUID WSAID_GETACCEPTEXSOCKADDRS est défini dans le fichier d’en-tête Mswsock.h .

Windows Phone 8 : cette fonction est prise en charge pour les applications du Store Windows Phone Windows Phone 8 et versions ultérieures.

Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winsock.h (inclure Mswsock.h)
Bibliothèque	Mswsock.lib
DLL	Mswsock.dll