General Support

[Netbios is not supported on Windows Vista, Windows Server 2008, and subsequent versions of the operating system]

The following are the general support commands:

  • NCBASTAT (adapter status)
  • NCBCANCEL (cancel)
  • NCBRESET (reset)

The NCBRESET command clears the name and session tables. It also ends all pending commands and sessions for the network route specified by the ncb_lana_num member of the NCB structure. A process is required to issue the NCBRESET command on each LANA number before it can issue any other NetBIOS command on the LANA number, with the exception of NCBENUM. This process is shown in the following illustration.

 

Bb870896.netbiosc(en-us,VS.85).png

 

The NCBASTAT command returns the current status and operation information about the network route specified in the ncb_lana_num member of the NCB structure. The ncb_buffer member receives an ADAPTER_STATUS structure, followed by an array of NAME_BUFFER structures.

The NCBASTAT command can be issued for the local computer or a remote computer. If the ncb_callname member contains an asterisk (*), information is returned for the local computer. If ncb_callname contains a NetBIOS name, the transport provider requests information from the remote computer where the name is registered, as shown in the following illustration.

 

Bb870896.netbiosd(en-us,VS.85).png

 

The NCBCANCEL command cancels the command listed in the ncb_command member of the NCB structure passed to the Netbios function. NCBCANCEL closes the associated session when canceling the following commands:

  • NCBCALL
  • NCBCHAINSEND
  • NCBHANGUP
  • NCBLISTEN
  • NCBSEND

The emulator simply returns NRC_CMDCAN if the following commands are successfully canceled or it returns NRC_CANOCCR if they finish before they could be canceled:

  • NCBDGRECV
  • NCBDGRECVBC
  • NCBLANSTALERT
  • NCBRECV
  • NCBRECVANY

The following commands cannot be canceled:

  • NCBADDGRNAME
  • NCBADDNAME
  • NCBCANCEL
  • NCBDELNAME
  • NCBDGSEND
  • NCBDGSENDBC
  • NCBRESET
  • NCBSSTAT

An asynchronous NCBACTION command cannot be canceled using NCBCANCEL. To cancel a synchronous NCBACTION command, the transport provider must support an action code that cancels other action codes. Alternatively, you can cancel the command by hanging up the session, deleting the name, or resetting the LANA number.

 

 

Send comments about this topic to Microsoft

Build date: 7/2/2010

Show: