/*****************************************************************************
Copyright (c) netsecsp 2012-2032, All rights reserved.

Developer: Shengqian Yang, from China, E-mail: netsecsp@hotmail.com, last updated 05/01/2022
http://asynframe.sf.net

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:

* Redistributions of source code must retain the above
copyright notice, this list of conditions and the
following disclaimer.

* Redistributions in binary form must reproduce the
above copyright notice, this list of conditions
and the following disclaimer in the documentation
and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*****************************************************************************/
import "IAsynNetwork.idl";

    cpp_quote("#pragma pack(push, 1)")

    /////////////////////////////////////////////////////////////////////////////
    [// 提供协议代理服务接口: 自动识别代理协议版本, 返回IAsynIoBridge, 显式继承IAsynMessageEvents, 用于处理外部接入tcp连接
        object,
        uuid(68E29861-A676-4b82-803C-785CD0D75D6D),
        helpstring("IAsynNetAgent Interface"),
        pointer_default(unique)
    ]
    interface IAsynNetAgent : IAsynMessageEvents
    {
        //注意: IAsynIoOperation可能携带数据或参数，接入Tcp连接协议代理: http/ftp/socks/telnet/pop3/smtp/rtmp/rtsp/mms, 返回IAsynIoBridge接口
        //                                                  端口转发: forward schema://[host]:port[/?k=v], udp/tcp
        HRESULT Connect( [in ]IAsynRawSocket* pAsynSrcSocket, [in ]STRING Protocol, [in ]IAsynIoOperation* pAsynIoOperation, [in ]uint32_t lTimeoutms );
    };

    cpp_quote("#pragma pack(pop)")