Platform SDK: DLC/NetBIOS

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,       // command control block
  PLLC_CCB *ppBadCcb   // invalid CCB
);

Parameters

pCcb
[in/out] Pointer to an LLC_CCB structure describing the command to be performed.
ppBadCcb
[out] 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.

Requirements

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Dlcapi.h.
  Library: Use Dlcapi.lib.

See Also

The DLC Interface Overview, DLC Functions, LLC_CCB