IPX/SPX Programming Manual

Library Routines
HP NonStop IPX/SPX Programming Manual—528022-001
5-24
getpeername, getpeername_nw
address_len_ptr
is maintained only for compatibility and should point to a value indicating the size in
bytes of the IPX address data structure pointed to by address_ptr.
tag
is the tag parameter to be used for the nowait operation initiated by
getpeername_nw.
Errors
If an error occurs, the external variable errno is set to one of the following values:
Usage Guidelines
•
Use getpeername on a socket created for waited operations, or
getpeername_nw on a socket created for nowait operations. The operation
initiated by getpeername_nw must be completed with a call to the AWAITIOX
procedure.
•
Complete the operation initiated by getpeername_nw must be with a call to the
Guardian AWAITIOX procedure.
•
If an unconnected socket is specified in a call to either the getpeername or
getpeername_nw, the function fails. This is typical of socket implementations.
For information on error checking, see Nowait Call Errors on page 5-5.
For information about struct sockaddr_nv and struct sockaddr, see
NonStop IPX/SPX Data Structures on page 4-2.
ENOTCONN The specified socket was not connected.
EINVAL One of the specified arguments was invalid.