8 mac_getdevice, 9 mac_getipbyname – ElmoMC Multi-Axis Motion Controller-Maestro User Manual
Page 114
6.8
MAC_GetDevice
This function enables the user to get Multi-axes supervisor parameters
Syntax:
int MAC_GetDevice
( UINT uNum, LPTSTR szIP, LPTSTR szName );
Input Parameters:
UINT uNum
Device number in this search results
Output Parameter:
LPTSTR szIP - IP address of supervisor (string with length 16 bytes minimum).
LPTSTR szName - Name of supervisor (string with length 32 bytes minimum).
Return Value:
int - command status: if 0 - OK,
else - error code:
1 - The API library is not initialized;
2 - The device is not found;
Use MAC_GetLastError to retrieve the error string.
Sample:
int retVal = MAC_GetDevice( 0, szIP, szName );
6.9
MAC_GetIpByName
This function enables the user to get Multi-axes supervisor IP address by name
Syntax:
int MAC_GetIpByName
( LPCTSTR cszName, LPTSTR szIP );
Input Parameters:
LPCTSTR cszName - Name of supervisor (string with length 32 bytes minimum).
Output Parameter:
LPTSTR szIP - IP address of supervisor (string with length 16 bytes minimum).
Return Value:
int - command status: if 0 - OK,
else
error
code:
1
The API library is not initialized;
2
The device is not found;
Use MAC_GetLastError to retrieve the error string.
Sample:
int retVal = MAC_GetIpByName( _T("MAS_1"), szIP );
Maestro
Software Manual
The Maestro API
MAN-MASSW (Ver. Q)
6-7