AcsLan

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
);
 

Parameters

pCcb
Pointer to an LLC_CCB structure describing the command to be performed.
ppBadCcb
Pointer to a pointer to an LLC_CCB structure. Use this parameter when you chain DLC commands. If the parameter is not NULL on input, this pointer will receive a pointer to the first invalid LLC_CCB structure in the chain.

Return Values

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.

QuickInfo

  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.

See Also

The DLC Interface Overview, DLC Functions, LLC_CCB