IFWXConnection::Deny Method

Denies the current operation on the connection object.

HRESULT Deny(
  DWORD Reserved
);

Parameters

Reserved

[in] Reserved for future use. Must be zero.

Return Values

S_OK

The connection will be denied.

E_INVALIDARG

Invalid value was passed to the Reserved parameter.

FWX_E_BAD_CONTEXT

The method was not called while handling any of the supported events.

Remarks

This method is rarely used. Using "Protocol Rules" and "Site and Content Rules" administration methods is the preferred way to control user activity.

This method must only be called in the context of the IFWXSessionFilter::FirewallEventHandler method while handling events with one of the following values:

• fwx_AcceptedConnection
• fwx_Bind_Udp
• fwx_Bind_Tcp
• fwx_Connect_Tcp

The action that caused the event will be canceled. A bind operation will fail with error code 10048 (WSAEADDRINUSE), a connect operation will fail with error code 10061 (WSAECONNREFUSED). An accepted connection will be aborted.

Note  For an fwx_Udp_Destination event, use the IFWXUdpDestination::Deny method instead of IFWXConnection::Deny. Outbound UDP packets sent to a denied destination will be discarded.