FDO .NET API Reference Feature Data Objects

mgIReleaseLock.h

Go to the documentation of this file.
00001 /*
00002 * Copyright (C) 2004-2006  Autodesk, Inc.
00003 * 
00004 * This library is free software; you can redistribute it and/or
00005 * modify it under the terms of version 2.1 of the GNU Lesser
00006 * General Public License as published by the Free Software Foundation.
00007 * 
00008 * This library is distributed in the hope that it will be useful,
00009 * but WITHOUT ANY WARRANTY; without even the implied warranty of
00010 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00011 * Lesser General Public License for more details.
00012 * 
00013 * You should have received a copy of the GNU Lesser General Public
00014 * License along with this library; if not, write to the Free Software
00015 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
00016 *
00017 */
00018 
00019 #pragma once
00020 
00021 #include "FDO\Commands\mgIFeatureCommand.h"
00022 
00023 BEGIN_NAMESPACE_OSGEO_FDO_COMMANDS_LOCKING
00024 public __gc __interface ILockConflictReader;
00025 
00026 /// \ingroup (OSGeoFDOCommandsLocking)
00027 /// \interface OSGeo::FDO::Commands::Locking::IReleaseLock
00028 /// \brief
00029 /// The IReleaseLock interface defines the ReleaseLock command, which releases
00030 /// locks from feature instances of a given class that match the specified
00031 /// criteria. Input to the release lock command includes the name of the class
00032 /// and filter criteria by which to identify the instances to be unlocked. The
00033 /// filter may be specified either as text or as an expression tree (most likely
00034 /// produced by a query builder). The ability to successfully execute the command 
00035 /// might be restricted by the datastore security if the lock doesn’t belong to the 
00036 /// user executing the command.
00037 public __gc __interface IReleaseLock : public NAMESPACE_OSGEO_FDO_COMMANDS::IFeatureCommand
00038 {
00039 public:
00040     /// \brief
00041     /// Gets the name of the user who owns the lock to release.
00042     /// 
00043     /// \return
00044     /// Returns name of the lock owner. If the name was not set, it returns the name of the caller.
00045     /// 
00046     __property System::String* get_LockOwner();
00047 
00048     /// \brief
00049     /// Sets the name of the user who owns the lock to release.
00050     /// 
00051     /// \param value 
00052     /// Input the name of the user.
00053     /// 
00054     /// \return
00055     /// Returns nothing
00056     /// 
00057     __property System::Void set_LockOwner(System::String* value);
00058 
00059     /// \brief
00060     /// Executes the release lock command, returning an ILockConflictReader.
00061     /// 
00062     /// \return
00063     /// Returns a list of feature instances whose lock is owned by someone else.
00064     /// 
00065     NAMESPACE_OSGEO_FDO_COMMANDS_LOCKING::ILockConflictReader* Execute();
00066 };
00067 
00068 END_NAMESPACE_OSGEO_FDO_COMMANDS_LOCKING
00069 
00070 

Comments or suggestions? Send us feedback.