1408a4873SAndrew Rist/************************************************************** 2cdf0e10cSrcweir * 3408a4873SAndrew Rist * Licensed to the Apache Software Foundation (ASF) under one 4408a4873SAndrew Rist * or more contributor license agreements. See the NOTICE file 5408a4873SAndrew Rist * distributed with this work for additional information 6408a4873SAndrew Rist * regarding copyright ownership. The ASF licenses this file 7408a4873SAndrew Rist * to you under the Apache License, Version 2.0 (the 8408a4873SAndrew Rist * "License"); you may not use this file except in compliance 9408a4873SAndrew Rist * with the License. You may obtain a copy of the License at 10408a4873SAndrew Rist * 11408a4873SAndrew Rist * http://www.apache.org/licenses/LICENSE-2.0 12408a4873SAndrew Rist * 13408a4873SAndrew Rist * Unless required by applicable law or agreed to in writing, 14408a4873SAndrew Rist * software distributed under the License is distributed on an 15408a4873SAndrew Rist * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16408a4873SAndrew Rist * KIND, either express or implied. See the License for the 17408a4873SAndrew Rist * specific language governing permissions and limitations 18408a4873SAndrew Rist * under the License. 19408a4873SAndrew Rist * 20408a4873SAndrew Rist *************************************************************/ 21408a4873SAndrew Rist 22408a4873SAndrew Rist 23cdf0e10cSrcweir#ifndef _COM_SUN_STAR_CONNECTION_XCONNECTOR_IDL_ 24cdf0e10cSrcweir#define _COM_SUN_STAR_CONNECTION_XCONNECTOR_IDL_ 25cdf0e10cSrcweir 26cdf0e10cSrcweir#include <com/sun/star/connection/ConnectionSetupException.idl> 27cdf0e10cSrcweir#include <com/sun/star/connection/NoConnectException.idl> 28cdf0e10cSrcweir#include <com/sun/star/lang/IllegalArgumentException.idl> 29cdf0e10cSrcweir#include <com/sun/star/connection/XConnection.idl> 30cdf0e10cSrcweir 31cdf0e10cSrcweir 32cdf0e10cSrcweirmodule com { module sun { module star { module connection { 33cdf0e10cSrcweir 34cdf0e10cSrcweir/** 35cdf0e10cSrcweir allows to actively establish an interprocess connection. 36cdf0e10cSrcweir */ 37cdf0e10cSrcweirpublished interface XConnector: com::sun::star::uno::XInterface 38cdf0e10cSrcweir{ 39cdf0e10cSrcweir 40cdf0e10cSrcweir // DocMerge from xml: method com::sun::star::connection::XConnector::connect 41cdf0e10cSrcweir /** creates a new connection interprocess connection. 42cdf0e10cSrcweir <p> 43cdf0e10cSrcweir Tries to connect to an <type>XAcceptor</type>. Behavior is unspecified 44cdf0e10cSrcweir if a call to connect is made when another call to connect either has not 45cdf0e10cSrcweir yet returned or has returned successfully without raising an exception. 46cdf0e10cSrcweir 47cdf0e10cSrcweir @param sConnectionDescription 48cdf0e10cSrcweir contains the kind of the connection plus a 49*86e1cf34SPedro Giffuni comma separated list of attributes, 50cdf0e10cSrcweir e.g., <em>socket,host=locahost,port=2345</em> for a tcpip connection. 51cdf0e10cSrcweir 52cdf0e10cSrcweir @throws ConnectionSetupException 53cdf0e10cSrcweir Problems during setting up the connector 54cdf0e10cSrcweir on client side, (e.g., Security-reasons, socket already busy .. ), 55cdf0e10cSrcweir or the string could not be interpreted correctly. 56cdf0e10cSrcweir 57cdf0e10cSrcweir @throws NoConnectException 58cdf0e10cSrcweir Couldn't reach a server (e.g. network failure), 59cdf0e10cSrcweir no server is listening 60cdf0e10cSrcweir */ 61cdf0e10cSrcweir XConnection connect( [in] string sConnectionDescription ) 62cdf0e10cSrcweir raises( NoConnectException,ConnectionSetupException ); 63cdf0e10cSrcweir}; 64cdf0e10cSrcweir 65cdf0e10cSrcweir 66cdf0e10cSrcweir};};};}; 67cdf0e10cSrcweir 68cdf0e10cSrcweir#endif 69