TdiBuildNetbiosAddressEa function

TdiBuildNetbiosAddressEa sets up a buffered NetBIOS address that the caller can pass subsequently to ZwCreateFile as the EaBuffer parameter.

Syntax

NTSTATUS TdiBuildNetbiosAddressEa(
  _Out_ PUCHAR  Buffer,
  _In_  BOOLEAN IsGroupName,
  _In_  PUCHAR  NetbiosName
);

Parameters

• Buffer [out]
  Pointer to a caller-supplied buffer, which must be at least 40 bytes in length.

• IsGroupName [in]
  Specifies TRUE if the address to be set up is a group address.

• NetbiosName [in]
  Pointer to 16-byte buffer containing a NetBIOS name.

Return value

TdiBuildNetbiosAddressEa returns STATUS_SUCCESS if it set up the given EA buffer. Otherwise, it can return STATUS_UNSUCCESSFUL if the given buffer is too small or, possibly, a propagated error status if attempting to access the given parameters raised an exception.

Remarks

TdiBuildNetbiosAddressEa sets up the buffer in a manner suitable for calling ZwCreateFile to open a NetBIOS address, with a TA_NETBIOS_ADDRESS structure as the EA value.

For more information, see ZwCreateFile.

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

See also

TA_NETBIOS_ADDRESS

TdiBuildNetbiosAddress

Send comments about this topic to Microsoft