piut_netserverinfo

This function copies the default server node information and connection status into the provided buffers. All data is returned null-terminated and trimmed to fit in the provided buffers.

C format

int32 piut_netserverinfo(

char PIPTR * name,

int32 namelen,

char PIPTR * address,

int32 addresslen,

int32 PIPTR * connected );

Returns

>0

System Error

0

Success

Arguments

name (returned)

Default server machine network name

namelen (passed)

Size, in bytes, of the buffer name.

address (returned)

Default server machine network address

addresslen (passed)

Size, in bytes, of the buffer address

connected (returned)

TRUE if there is a valid connection to the current server or FALSE if there is no connection

Usage Notes

If a name of ?unknown? is returned, then the PI-API is not able to find the name of the default server in the local network database or hosts file.

On a DEC VAX PINet node the logical translation of PIHomeNode is returned for the name and the address is ?unknown?.

Enabling Operational Intelligence