Avaya IP Office CTI Link, Programmer'S Manual

Page: 17 / 28

DevLink Programmer’s Guide Page 17
IP Office CTI Link 40DHB0002UKAD Issue 11a (14th June 2005)
DevLink reference
Functions
DLOpen
The DLOpen() routine is used to connect to an IP Office system.
Parameters
• pbxh - A number used to identify the system. This is a user-supplied parameter that must remain
consistent across all calls to Dev Link .
• pbx_address - The IP address of the IP Office system (either a IP address or a host name can
be used). This may be set to "255.255.255.255" in which case Dev Link will make a network
broadcast to locate the system unit. Please note that only the first unit to respond will be
connected to; if you wish to connect to multiple system units, you must specify the IP address or
host name of the unit here.
• pbx_password - The password of the IP Office system.
• reserved1 - This parameter should be set to NULL (nil in Delphi)
•
reserved2 - This parameter should be set to NULL (nil in Delphi)
• cb - This is the address of a call-back function, to which connection status events will be sent.
This parameter is mandatory.
Return value
This routine may return either 0 (DEVLINK_SUCCESS) or 1 (DEVLINK_UNSPECIFIEDFAIL).
Note that a return value of DEVLINK_SUCCESS only indicates that communications with the unit has
been initiated; the subsequent connection may fail for several reasons. Further information will be
provided to the COMMSEVENT callback function specified in the cb parameter.
C / C++
LONG PASCAL DLOpen( LONG pbxh
, TEXT * pbx_address
, TEXT * pbx_password
, TEXT * reserved1
, TEXT * reserved2
, COMMSEVENT cb
);
Delphi
function DLOpen(pbxh: LongInt;
pbx_address: PChar;
pbx_password: PChar;
reserved1: PChar;
reserved2: PChar;
cb: TCommsEvent): LongInt; stdcall;