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.
Return Values
This function
does not return a value.
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.