Share via


IFWXSocket::SendTo method

Applies to: desktop apps only

The SendTo method sends a buffer asynchronously on UDP sockets to a specified address. It performs an overlapped sendto operation.

Syntax

HRESULT SendTo(
  [in]  IFWXIOBuffer *pIOBuffer,
  [in]  SOCKADDR *Address,
  [in]  INT AddressLength,
  [in]  IFWXIOCompletion *pIFWXIOCompletion,
  [in]  UserContextType UserData
);

Parameters

  • pIOBuffer [in]
    Pointer to the buffer to send.

  • Address [in]
    When calling this method on an external socket, this sockaddr structure should contain the target address for a UDP datagram. When calling this method on an internal socket, this parameter should contain the address of the datagram source. This is typically the Internet address from which the pIOBuffer packet originated. That is, the internal socket is associated with the Internet address of the pIOBuffer packet.

  • AddressLength [in]
    Length, in bytes, of the Address parameter.

  • pIFWXIOCompletion [in]
    Pointer to an IFWXIOCompletion interface that receives a notification when the sendto operation is completed. Set this parameter to NULL if notification is not required.

  • UserData [in]
    An opaque value to pass to the IFWXIOCompletion::CompleteAsyncIO notification method. This parameter provides a context to the notification.

Return value

This method returns S_OK if the call is successful; otherwise, it returns an error code.

For an IFWXNetworkSocket interface created by a call to IFWXFirewall2::CreateSSLNetworkSocket, this method returns E_NOTIMPL.

Remarks

To receive a notification when the sendto operation is completed, specify an IFWXIOCompletion interface pointer in the pIFWXIOCompletion parameter.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)

Version

Forefront Threat Management Gateway (TMG) 2010

Header

Wspfwext.idl

DLL

Wspsrv.exe

See also

IFWXSocket

 

 

Build date: 7/12/2010