The AcsLan function communicates with IBM mainframes or network peripheral devices, such as printers connected directly to the network, by using the data link control (DLC) protocol. You can submit commands by filling in a command control block (CCB) structure, LLC_CCB, and then calling AcsLan.
Commands submitted through AcsLan can complete synchronously or asynchronously. The DLC driver, not the caller, determines how a command completes.
ACSLAN_STATUS AcsLan(
PLLC_CCB pCcb, // pointer to the command control block
PLLC_CCB *ppBadCcb // pointer to a pointer to an invalid CCB
);
The function returns an ACSLAN_STATUS value. ACSLAN_STATUS is an enumerated type. The following values are defined.
Value | Meaning |
---|---|
ACSLAN_STATUS_COMMAND_ACCEPTED | The command has been processed and passed to the DLC driver. Asynchronous commands may or may not be completed. Check the uchDlcStatus member in the LLC_CCB structure to determine whether the command succeeded. |
ACSLAN_STATUS_INVALID_CCB_POINTER | A pointer in the LLC_CCB structure, or the parameter table is invalid. |
ACSLAN_STATUS_CCB_IN_ERROR | A problem was detected with the LLC_CCB structure. Check the values in the structure and resubmit it. |
ACSLAN_STATUS_CHAINED_CCB_IN_ERROR | A problem was detected with an LLC_CCB structure in a chain of LLC_CCB structures. |
ACSLAN_STATUS_SYSTEM_ERROR | This value is not used. |
ACSLAN_STATUS_SYSTEM_STATUS | This value is not used. |
ACSLAN_STATUS_INVALID_COMMAND | The command in the uchDlcCommand member of the LLC_CCB structure is unrecognized. |
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in dlcapi.h.
Import Library: Use dlcapi.lib.
The DLC Interface Overview, DLC Functions, LLC_CCB