3.2.4.20.10 Application Requests Querying Server's Network Interfaces

  • Article

This optional interface is applicable only for the SMB 3.x dialect family.

The application provides:

  • A handle to the TreeConnect.

If the handle is invalid, or if no TreeConnect referenced by the tree connect handle is found, the client MUST return an implementation-specific error code locally to the calling application.

The client initializes an SMB2 IOCTL Request following the syntax specified in section 2.2.31. The SMB2 header MUST be initialized as follows:

  • The Command field is set to SMB2 IOCTL.

  • The MessageId field is set as specified in section 3.2.4.1.3.

  • The SessionId field is set to TreeConnect.Session.SessionId.

  • The TreeId field is set to TreeConnect.TreeConnectId.

The SMB2 IOCTL Request MUST be initialized as specified in section 2.2.31, with the exception of the following values:

  • The CtlCode field is set to FSCTL_QUERY_NETWORK_INTERFACE_INFO.

  • The FileId field is set to { 0xFFFFFFFFFFFFFFFF, 0xFFFFFFFFFFFFFFFF }.

  • The InputCount field is set to 0.

  • The MaxInputResponse field is set to 0.

  • The MaxOutputResponse field is set to an implementation-specific<169> value.

  • SMB2_0_IOCTL_IS_FSCTL is set to TRUE in the Flags field.

The request MUST be sent to the server.