Retrieve the client host IP address for the client connection that is associated with a C or C++ component instance.
JagStatus JAG_PUBLIC JagGetPeerAddress( SQLPOINTER peerAddress, SQLINTEGER bufLen, SQLINTEGER *returnLen)
The address of a character array to receive the client IP address. The output value is “0.0.0.0” if the client’s IP address is unavailable.
The length, in bytes, of the peerAddress array. The length must include space for a null-terminator.
NULL or the address of a SQLINTEGER variable.
returnLen is an optional output parameter that receives the length, in bytes, of the peerAddress value. The host name is null-terminated and the length includes the null-terminator.
Return value |
To indicate |
|---|---|
JAG_SUCCEED |
Success |
JAG_FAIL |
Failure |
JagGetPeerAddress fails for the following reasons:
peerAddress was NULL.
The buffer length is insufficient.
The routine was called in code that was not executing in the context of a component method call.
Check the server’s log file for more information when JagGetPeerAddress fails.
