GetAcceptExSockaddrs

Notice This function is a Microsoft-specific extension to the Windows Sockets specification. For more information, see Microsoft Extensions and Windows Sockets 2.

The Windows Sockets GetAcceptExSockaddrs function parses the data obtained from a call to the AcceptEx function and passes the local and remote addresses to a SOCKADDR structure.

VOID GetAcceptExSockaddrs ( 
  PVOID lpOutputBuffer,       
  DWORD dwReceiveDataLength,  
  DWORD dwLocalAddressLength,  
  DWORD dwRemoteAddressLength,  
  LPSOCKADDR *LocalSockaddr,  
  LPINT LocalSockaddrLength,  
  LPSOCKADDR *RemoteSockaddr,  
  LPINT RemoteSockaddrLength  
);
 

Parameters

lpOutputBuffer

[in] A pointer to a buffer that receives the first block of data sent on a connection resulting from an AcceptEx call. It must be the same lpOutputBuffer parameter that was passed to the AcceptEx function.

dwReceiveDataLength

[in] The number of bytes in the buffer that will be used for receiving the first data. This must be equal to the dwReceiveDataLength parameter that was passed to the AcceptEx function.

dwLocalAddressLength

[in] The number of bytes reserved for the local address information. This must be equal to the dwLocalAddressLength parameter that was passed to the AcceptEx function.

dwRemoteAddressLength

[in] The number of bytes reserved for the remote address information. This must be equal to the dwRemoteAddressLength parameter that was passed to the AcceptEx function.

LocalSockaddr

[out] A pointer to the SOCKADDR structure that receives the local address of the connection (the same information that would be returned by the Windows Sockets getsockname function). This parameter must be specified.

LocalSockaddrLength

[out] The size of the local address. This parameter must be specified.

RemoteSockaddr

[out] A pointer to the SOCKADDR structure that receives the remote address of the connection (the same information that would be returned by the Windows Sockets getpeername function). This parameter must be specified.

RemoteSockaddrLength

[out] The size of the local address. This parameter must be specified.

Remarks

The GetAcceptExSockaddrs function is used exclusively with the AcceptEx function to parse the first data that the socket receives into local and remote addresses. You are required to use this function because the AcceptEx function writes address information in an internal (TDI) format. The GetAcceptExSockaddrs routine is required to locate the SOCKADDR structures in the buffer.

Return Values

This function does not return a value.

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in mswsock.h.
  Import Library: Link with mswsock.lib.