z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


getclientid()

z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference
SC27-3660-00

The getclientid() call returns the identifier by which the calling application is known to the TCP/IP address space. The clientid is used in givesocket() and takesocket() calls.

#include <manifest.h>
#include <socket.h>
#include <bsdtypes.h>
int  getclientid(int domain, struct clientid *clientid)
Parameter
Description
domain
The value in domain must be AF_INET.
clientid
Points to a clientid structure to be provided.

Return values

The value 0 indicates success. The value -1 indicates an error. Errno identifies the specific error.
Errno
Description
EFAULT
The clientid parameter as specified would result in an attempt to access storage outside the caller address space, or storage that cannot be modified by the caller.
EAFNOSUPPORT
The domain is not AF_INET.

Related calls

takesocket()

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014