This function returns the server name given the node identifier.

C format

PIINT32 pilg_getservername(

int32 lNodeId,

LPSTR lpszServerNameBuf,

int32 PIPTR * plBufSize)



System error




Server with the given node id does not exist


Application is not registered


No servers configured (pilogin.ini not found)


lNodeId (passed)

Node id of the server,

lpszServerNameBuf (returned)

Server name - pointer to null terminated string,

plBufSize(passed, returned)

Pointer to the buffer size . On entry it contains the size of the buffer. On return it contains the length of the server name.

Usage Notes

If the buffer is not big enough to hold the server name the name will be truncated.

Enabling Operational Intelligence