Microsoft Internet Security and Acceleration Server 2004 SDK

IFWXAcceptCompletion::CompleteAsyncAccept

The CompleteAsyncAccept method receives a notification that the work performed in a call to the IFWXNetworkSocket::Accept method is completed (that a client connected to the listening socket).

HRESULT CompleteAsyncAccept(
  BOOL fSuccess,
  DWORD Win32ErrorCode,
  IFWXNetworkSocket* pListeningSocket,
  IFWXNetworkSocket* pAcceptSocket,
  LPSOCKADDR RemoteAddress,
  DWORD RemoteAddressLength,
  LPSOCKADDR LocalAddress,
  DWORD LocalAddressLength,
  UserContextType UserData
);

Parameters

fSuccess
[in] Success flag. If TRUE, the IFWXNetworkSocket::Accept method succeeded. If FALSE, the method failed.
Win32ErrorCode
[in] Windows error code. This parameter is defined only if the fSuccess parameter is set to FALSE.
pListeningSocket
[in] Pointer to the IFWXNetworkSocket interface on the listening socket.
pAcceptSocket
[in] Pointer to the IFWXNetworkSocket interface on the newly accepted connection.
RemoteAddress
[in] Pointer to a sockaddr structure that contains the remote address of the connection. This is the same information that would be returned by the Windows Sockets (Winsock) getpeername function.
RemoteAddressLength
[in] Size, in bytes, of the buffer pointed to by the RemoteAddress parameter.
LocalAddress
[in] Pointer to a sockaddr structure that contains the local address of the connection. This is the same information that would be returned by the Winsock getsockname function.
LocalAddressLength
[in] Size, in bytes, of the buffer to which the LocalAddress parameter points.
UserData
[in] The UserData parameter that was supplied to the IFWXNetworkSocket::Accept method.

Return Values

Implementations of this method should handle any run-time error and return S_OK.

Remarks

The UserData parameter provides a context to the notification. You can use the same notification interface for receiving completion notifications from different network socket objects and differentiate among them by using different values for UserData.

Requirements

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

See Also

IFWXAcceptCompletion