Chapter 5 C Routines Reference

JagGetHostName

Description

Retrieve the client host name for the client connection that is associated with a C or C++ component instance.

Syntax

JagStatus JAG_PUBLIC JagGetHostName(
          SQLPOINTER hostName, 
          SQLINTEGER hostNameLen,
          SQLINTEGER *returnLen)

Parameters

hostName 

The address of a character array to receive the client host name or, if the client software did not supply a host name, a zero-length string.

   Java clients and JagGetHostName Java clients do not supply the client host name (there is no mechanism to retrieve the host name in Java).

hostNameLen 

The length, in bytes, of the hostName array. The length must include space for a null-terminator.

returnLen 

NULL or the address of a SQLINTEGER variable.

returnLen is an optional output parameter that receives the length, in bytes, of the hostName value. The host name is null-terminated and the length includes the null-terminator.

Return Values

JagGetHostName fails for the following reasons:

• hostName was NULL.
• The buffer length is insufficient.
• The routine was called in code that was not executing in the context of a Jaguar method call.

Check the server's log file for more information when JagGetHostName fails.

See Also

JagGetPeerAddress

Copyright © 2000 Sybase, Inc. All rights reserved.