diff options
Diffstat (limited to 'offapi/com/sun/star/sdbc/XOutParameters.idl')
-rw-r--r-- | offapi/com/sun/star/sdbc/XOutParameters.idl | 144 |
1 files changed, 0 insertions, 144 deletions
diff --git a/offapi/com/sun/star/sdbc/XOutParameters.idl b/offapi/com/sun/star/sdbc/XOutParameters.idl deleted file mode 100644 index 3446d32a7..000000000 --- a/offapi/com/sun/star/sdbc/XOutParameters.idl +++ /dev/null @@ -1,144 +0,0 @@ -/************************************************************************* - * - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. - * - * Copyright 2000, 2010 Oracle and/or its affiliates. - * - * OpenOffice.org - a multi-platform office productivity suite - * - * This file is part of OpenOffice.org. - * - * OpenOffice.org is free software: you can redistribute it and/or modify - * it under the terms of the GNU Lesser General Public License version 3 - * only, as published by the Free Software Foundation. - * - * OpenOffice.org is distributed in the hope that it will be useful, - * but WITHOUT ANY WARRANTY; without even the implied warranty of - * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - * GNU Lesser General Public License version 3 for more details - * (a copy is included in the LICENSE file that accompanied this code). - * - * You should have received a copy of the GNU Lesser General Public License - * version 3 along with OpenOffice.org. If not, see - * <http://www.openoffice.org/license.html> - * for a copy of the LGPLv3 License. - * - ************************************************************************/ -#ifndef __com_sun_star_sdbc_XOutParameters_idl__ -#define __com_sun_star_sdbc_XOutParameters_idl__ - -#include <com/sun/star/uno/XInterface.idl> - -#include <com/sun/star/sdbc/SQLException.idl> - - module com { module sun { module star { module sdbc { - - -/** is used to register Out-Parameters for stored procedures. - - - <p> - SDBC provides a stored procedure SQL escape that allows stored procedures - to be called in a standard way for all RDBMSs. This escape syntax has one - form that includes a result parameter and one that does not. If used, the - result parameter must be registered as an OUT parameter. The other parameters - can be used for input, output, or both. Parameters are referred to sequentially, - by number. The first parameter is 1. - </p> - */ -published interface XOutParameters: com::sun::star::uno::XInterface -{ - - /** registers the designated output parameter. This version of - the method - <member scope="com::sun::star::sdbc">XOutParameters::registerOutParameter()</member> - should be used for a user-named or REF output parameter. Examples - of user-named types include: STRUCT, DISTINCT, OBJECT, and named array - types. - - - <p> - Before executing a stored procedure call, you must explicitly - call - <member scope="com::sun::star::sdbc">XOutParameters::registerOutParameter()</member> - to register the type from - <type scope="com::sun::star::sdbc">DataType</type> - for each OUT parameter. - <br/> - For a user-named parameter the fully-qualified SQL type name of the - parameter should also be given, while a REF parameter requires that the - fully-qualified type name of the referenced type be given. - An SDBC driver that does not need the type code and type name information - may ignore it. To be portable, however, applications should always provide - these values for user-named and REF parameters. - </p> - <p>Although it is intended for user-named and REF parameters, - this method may be used to register a parameter of any SDBC type. - If the parameter does not have a user-named or REF type, the - typeName parameter is ignored. - </p> - <p> - <b>Note:</b> When reading the value of an out parameter, you - must use the - <code>getXXX</code> - method whose type XXX corresponds to the - parameter's registered SQL type. - </p> - @param parameterIndex - the first parameter is 1, the second is 2, ... - @param sqlType - the type of the column to register - @param typeName - the name of the type - @throws SQLException - if a database access error occurs. - */ - void registerOutParameter([in]long parameterIndex, [in]long sqlType, - [in]string typeName) - raises (SQLException); - //------------------------------------------------------------------------- - - /** registers the OUT parameter in ordinal position - <code>parameterIndex</code> - to the SDBC type - <code>sqlType</code> - . All - OUT parameters must be registered before a stored procedure is executed. - - - <p> - The SDBC type specified by - <code>sqlType</code> - for an OUT parameter determines the type that must be used in the - <code>get</code> - method to read the value of that parameter. - This version of - <member scope="com::sun::star::sdbc">XOutParameters::registerOutParameter()</member> - should be - used when the parameter is of SDBC type - <member scope="com::sun::star::sdbc">DataType::NUMERIC</member> - or - <member scope="com::sun::star::sdbc">DataType::DECIMAL</member> - . - @param parameterIndex - the first parameter is 1, the second is 2, ... - @param sqlType - the type of the column to register - @param scale - the scale of the type - @throws SQLException - if a database access error occurs. - </p> - */ - void registerNumericOutParameter([in]long parameterIndex, [in]long sqlType, - [in]long scale) - raises (SQLException); -}; - -//============================================================================= - -}; }; }; }; - -/*=========================================================================== -===========================================================================*/ -#endif |