WSASetIPUserMtu function (ws2tcpip.h)

Sets the user-defined IP layer MTU on a socket.

Syntax

INT WSASetIPUserMtu(
  [in] SOCKET Socket,
  [in] DWORD  Mtu
);

Parameters

[in] Socket

A descriptor that identifies a socket.

[in] Mtu

Type: DWORD

The user-defined IP layer MTU to be set on the socket.

Return value

On success, the function returns 0. Otherwise, a value of SOCKET_ERROR is returned, and you can retrieve a specific error code by calling WSAGetLastError.

Remarks

This functionality is supported through the IP_USER_MTU socket option. WSASetIPUserMtu is a type-safe wrapper for setting this socket option, and we recommend it over setsockopt.

Requirements