Share via


TDI_ADDRESS_NETBIOS_EX structure

The TDI_ADDRESS_NETBIOS_EX structure contains an extended NetBIOS address, packed and aligned correctly.

Syntax

typedef struct _TDI_ADDRESS_NETBIOS_EX {
  UCHAR               EndpointName[16];
  TDI_ADDRESS_NETBIOS NetbiosAddress;
} TDI_ADDRESS_NETBIOS_EX, *PTDI_ADDRESS_NETBIOS_EX;

Members

  • EndpointName
    Specifies the name to be presented to the destination machine in the NETBIOS session-setup request packet.

  • NetbiosAddress
    Specifies a NetBIOS address from which the local-node transport derives the transport address of the target remote node.

Remarks

A TRANSPORT_ADDRESS structure contains a specified number of elements of type TA_ADDRESS. TDI_ADDRESS_NETBIOS_EX defines the Address member of a TA_ADDRESS structure in which the AddressType is set to TDI_ADDRESS_TYPE_NETBIOS_EX.

The AddressLength member(s) of the TA_ADDRESS substructure(s) can be set to the system-defined constant TDI_ADDRESS_LENGTH_NETBIOS_EX.

This structure can be used by a kernel-mode client connecting to a NETBIOS service on a remote machine, assuming the underlying TDI transport supports this operation.

For example, suppose the registered name for the NETBIOS service on a remote machine is "FooService" and the DNS name for the remote machine is something like "MyRemoteMachine.Microsoft.com." Such a client could use a TDI_ADDRESS_NETBIOS_EX structure in which EndpointName was set to FooService and NetbiosAddress was set to MyRemoteMachine.Microsoft.com when the client issued the TDI_CONNECT request to its underlying transport.

The system-supplied NETBT (NetBIOS over TCP/IP) transport uses the TDI_ADDRESS_NETBIOS_EX structure in this manner to support the SMB file server/redirector.

Note   The TDI feature is deprecated and will be removed in future versions of Microsoft Windows. Depending on how you use TDI, use either the Winsock Kernel (WSK) or Windows Filtering Platform (WFP). For more information about WFP and WSK, see Windows Filtering Platform and Winsock Kernel. For a Windows Core Networking blog entry about WSK and TDI, see Introduction to Winsock Kernel (WSK).

 

Requirements

Header

Tdi.h (include Tdi.h or TdiKrnl.h)

See also

TA_ADDRESS

TA_NETBIOS_ADDRESS

TDI_ADDRESS_NETBIOS

TRANSPORT_ADDRESS

 

 

Send comments about this topic to Microsoft