pilg_getservername

This function returns the server name given the node identifier.

C format

PIINT32 pilg_getservername(

int32 lNodeId,

LPSTR lpszServerNameBuf,

int32 PIPTR * plBufSize)

Returns

>0

System error

0

Success

-7

Server with the given node id does not exist

-103

Application is not registered

-106

No servers configured (pilogin.ini not found)

Arguments

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