FDO API Reference |
Feature Data Objects |
FdoIAcquireLock Class Reference
#include <IAcquireLock.h>
Inherits FdoIFeatureCommand.
Inheritance diagram for FdoIAcquireLock:
[legend]List of all members.
Detailed Description
The FdoIAcquireLock interface locks feature instances of a given class that match the specified criteria. Input to the acquire lock command includes the name of the class, the lock type, the lock strategy, and filter criteria by which to identify the instances to be locked. The filter may be specified either as text or as an expression tree (most likely produced by a query builder). The lock type value is one of
- FdoLockType_Shared
- FdoLockType_Exclusive
- FdoLockType_Transaction
- FdoLockType_LongTransactionExclusive
- FdoLockType_AllLongTransactionExclusive.
- Remarks:
- If the lock strategy has a value of all and at least one of the feature instances specified in the filter is locked by someone else, the command returns an FdoILockConflictReader list which contains all of the feature instances specified in the filter.
If the lock strategy has a value of partial, the command returns an FdoILockConflictReader list which contains all of the feature instances specified in the filter that are already locked by someone else. The command returns an empty FdoILockConflictReader list if all of the feature instances specified in the filter were successfully locked.
Definition at line 55 of file IAcquireLock.h.
Member Function Documentation
|
Executes the AcquireLock command, returning an FdoILockConflictReader.
- Returns:
- Returns a list of feature instances which could not be locked. The list could be empty indicating that all of the feature instances specified in the filter have been locked, or it could contain the list of feature instances that could not be locked because they are already locked by someone or because the locking strategy is all and at least one of the feature instances specified in the filter is already locked by someone else.
|
virtual FDO_API FdoLockStrategy FdoIAcquireLock::GetLockStrategy |
( |
|
) |
[pure virtual] |
|
|
Gets the FdoLockStrategy value.
- Returns:
- Returns the strategy value (all or partial).
|
virtual FDO_API FdoLockType FdoIAcquireLock::GetLockType |
( |
|
) |
[pure virtual] |
|
|
Gets the FdoLockType value.
- Returns:
- Returns the lock type.
|
virtual FDO_API void FdoIAcquireLock::SetLockStrategy |
( |
FdoLockStrategy |
value |
) |
[pure virtual] |
|
|
Sets the FdoLockStrategy value (all or partial).
- Parameters:
-
| value | Input the lock strategy used for locking objects |
- Returns:
- Returns nothing
|
virtual FDO_API void FdoIAcquireLock::SetLockType |
( |
FdoLockType |
value |
) |
[pure virtual] |
|
|
Sets the FdoLockType value.
- Parameters:
-
| value | Input the lock type |
- Returns:
- Returns nothing
|
Friends And Related Function Documentation
The documentation for this class was generated from the following file:
Comments or suggestions? Send us feedback. |