MgslDlSetAddressList


Prototype
ULONG MgslDlSetAddressList( HANDLE hDevice,
                            PMGSL_ADDRESS_LIST List );
Parameters
Hdevice
handle to open port
Params
pointer to application initialized MGSL_ADDRESS_LIST structure
Return Value
ERROR_SUCCESS
Parameters set successfully
ERROR_INVALID_PARAMETER
List pointer or contents invalid
ERROR_INVALID_HANDLE
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 the MGSL_ADDRESS_LIST structure reference for more details.


Previous Contents Next