Microsoft Internet Security and Acceleration Server 2004 SDK

IFWXFirewall::CreateNetworkSocket

The CreateNetworkSocket method creates a socket object that works with the dynamic packet filtering scheme.

HRESULT CreateNetworkSocket(
  INT Protocol,
  IFWXNetworkSocket** piSocket
);

Parameters

Protocol
[in] Protocol flags. This parameter can have the following flag values:
Value Meaning
FWX_PROTOCOL_TCP The method will create a TCP socket.
FWX_PROTOCOL_UDP The method will create a UDP socket.
piSocket
[out] Address of a variable that receives a pointer to the IFWXNetworkSocket interface.

Return Values

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

Remarks

Filters must use this interface and not call the Winsock dynamic-link library (DLL) directly to create a socket. The ISA Server socket object automatically opens packet filter ports required for any operation made with this socket. Sockets created with the Winsock DLL will not work with the dynamic packet filtering of ISA Server.

A socket created by this method is not associated with a specific user and will therefore always be successfully created regardless of ISA Server access policy. To create a socket that is user-specific, use the IFWXSession::CreateNetworkSocket method.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wspfwext.idl.

See Also

IFWXFirewall