GetTCPHostName

int GetTCPHostName (char buffer[], int bufferSize);

Purpose

Obtains the name of the computer on which your program is currently running.

Parameters

Input
Name Type Description
bufferSize integer Number of bytes in buffer, including space for the ASCII NUL byte.
Output
Name Type Description
buffer character array Buffer that GetTCPHostName fills with the name of the computer on which your program is currently running.

Return Value

Name Type Description
status integer Return value indicating whether the function was successful. Unless otherwise stated, zero represents successful execution and a negative number represents the error code.

You can call the GetTCPSystemErrorString function to obtain a system message that describes the error. The system messages can be more descriptive than the TCP Library error codes. To obtain the correct system error message, you must call GetTCPSystemErrorString immediately after calling the TCP Library function that failed.

For functions that read or write data (ClientTCPRead, ClientTCPWrite, ServerTCPRead, ServerTCPWrite), if the function was successful, the return value is the number of bytes transferred.

You can have a maximum of 255 concurrent conversations and up to 1,024 connections. If you exceed this limit, -kTCP_TooManyConnections will be returned. You may not be able to open the maximum number of connections allowed by LabWindows/CVI because of limitations imposed by the operating system.