1/************************************************************************* 2 * 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * Copyright 2000, 2010 Oracle and/or its affiliates. 6 * 7 * OpenOffice.org - a multi-platform office productivity suite 8 * 9 * This file is part of OpenOffice.org. 10 * 11 * OpenOffice.org is free software: you can redistribute it and/or modify 12 * it under the terms of the GNU Lesser General Public License version 3 13 * only, as published by the Free Software Foundation. 14 * 15 * OpenOffice.org is distributed in the hope that it will be useful, 16 * but WITHOUT ANY WARRANTY; without even the implied warranty of 17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18 * GNU Lesser General Public License version 3 for more details 19 * (a copy is included in the LICENSE file that accompanied this code). 20 * 21 * You should have received a copy of the GNU Lesser General Public License 22 * version 3 along with OpenOffice.org. If not, see 23 * <http://www.openoffice.org/license.html> 24 * for a copy of the LGPLv3 License. 25 * 26 ************************************************************************/ 27#ifndef _COM_SUN_STAR_CONNECTION_XACCEPTOR_IDL_ 28#define _COM_SUN_STAR_CONNECTION_XACCEPTOR_IDL_ 29 30#include <com/sun/star/connection/ConnectionSetupException.idl> 31#include <com/sun/star/connection/AlreadyAcceptingException.idl> 32#include <com/sun/star/lang/IllegalArgumentException.idl> 33#include <com/sun/star/connection/XConnection.idl> 34 35 36module com { module sun { module star { module connection { 37 38/** allows to passively accept connection attempts from other processes. 39 40 <p> 41 This is the counterpart to the XConnector interface. 42 */ 43published interface XAcceptor: com::sun::star::uno::XInterface 44{ 45 // DocMerge from xml: method com::sun::star::connection::XAcceptor::accept 46 /** accepts an interprocess connection. Waits until someone connects to the resource. 47 <p> 48 After a successful return, the method may be called again to accept 49 further connections, but the parameter string MUST be left unchanged. 50 51 52 @param sConnectionDescription 53 contains the kind of the connection plus a 54 comma seperated list of attributes, 55 e.g., <em>socket,host=localhost,port=2345</em> for a tcpip connection. 56 57 @return null reference, 58 stopAccepting was called. 59 Otherwise a valid XConnection reference. 60 61 @throws AlreadyAcceptingException 62 Only one acceptor-thread per instance allowed. 63 @throws ConnectionSetupException 64 Problems during setting up the acceptor. 65 (e.g., Security-reasons, socket already busy, etc.) 66 @throws com::sun::star::lang::IllegalArgumentException 67 sConnectionDescription could not be interpreted 68 69 */ 70 XConnection accept( [in] string sConnectionDescription ) 71 raises( AlreadyAcceptingException, 72 ConnectionSetupException, 73 com::sun::star::lang::IllegalArgumentException); 74 75 76 /** pushes acceptor out of the accept-call. 77 */ 78 void stopAccepting(); 79}; 80 81};};};}; 82 83#endif 84