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
Target platform |
Universal |
Header |
Tdikrnl.h (include TdiKrnl.h) |
Library |
Tdi.lib |
See also