| Prototype | |
|
|
| Parameters | |
|
handle to open port |
|
pointer to application initialized
MGSL_ADDRESS_LIST
structure |
| Return Value | |
|
Parameters set successfully |
|
List pointer or contents invalid |
|
hDevice or Link is invalid |
Set an address list associated with a link instance.
Normally a link uses only the addresses contained in the MGSL_DLPARAMS structure (local, remote, and broadcast). Some applications require a single link to recognize multiple addresses. When multiple addresses are required, use this API call to associate a list of HDLC addresses with a specific link instance.
The address lists are used only when evaluating received frames. These lists are not used for sending frames. Received frames are checked for matches against the addresses in the MGSL_DLPARAMS structure before referring to the address lists.
Two address lists are defined: local and remote.
Frames received with an HDLC address matching an entry in the local address list are commands.
Frames received with an HDLC address matching an entry in the remote address list are responses.
See theMGSL_ADDRESS_LIST structure reference for more
details.
| Previous | Contents | Next |