WSHAddressToString
INT
WSHAddressToString(
IN LPSOCKADDR Address,
IN INT AddressLength,
IN LPWSAPROTOCOL_INFOW ProtocolInfo OPTIONAL,
OUT LPWSTR AddressString,
IN OUT LPDWORD AddressStringLength
);
WSHAddressToString returns a logical string representation of a socket
address that is generally used for display purposes.
Parameters
-
Address
-
Points to a SOCKADDR to convert.
-
AddressLength
-
Specifies the number of bytes at Address.
-
ProtocolInfo
-
Points to a WSAPROTOCOL_INFOW structure passed in a user-mode call to WSAAddressToString,
or is NULL.
-
AddressString
-
Points to a caller-provided buffer into which the helper DLL should copy the
logical string representation of the address.
-
AddressStringLength
-
On input, points to a variable specifying the length in bytes of the buffer
provided at AddressString. On return, the helper DLL should reset the
value to the number of bytes it actually copied into the buffer at AddressString.
Return Value
WSHAddressToString either returns zero to indicate success or one of
the following:
-
WSAEFAULT
-
The buffer specified at AddressString is too small to copy the logical
representation of the address.
-
WSAEINVAL
-
The address specified at Address is not a valid address to be
translated.
See Also
WSHStringToAddress