piut_netnodeinfo

This function gets the network information for the passed node name. All data is returned null-terminated and trimmed to fit in the provided buffers.

C format

int32 piut_netnodeinfo(

char PIPTR * name,

int32 namelen,

char PIPTR * address,

int32 addresslen,

int32 PIPTR * connected );

Returns

>0

System Error

0

Success

Arguments

name (passed)

Server machine network name of a the node to be resolved

namelen (passed)

Size, in bytes, of the buffer name

address (returned)

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

On a DEC VAX the name is ignored and information about the PI Home node is returned. On a PINet node the address returned will always be ?unknown?

Enabling Operational Intelligence