LockObject (Command Interface)

Analysis Services Programming

Analysis Services Programming

LockObject (Command Interface)

The LockObject method of the Command interface locks an object to prevent multiple users from concurrently changing the object.

Applies To

clsDatabaseCommand

Syntax

object.LockObject(ByVal LockType As OlapLockTypes, ByVal LockDescription As String)

object

The object to lock.

LockType

One of the lock types of the OlapLockTypes enumeration. For more information, see OlapLockTypes.

LockDescription

A string that contains a description of the lock. This argument is available to other applications attempting to obtain a lock.

Remarks

Of the four types of locks defined by the OlapLockTypes enumeration, only OlapLockRead and OlapLockWrite apply to the Command interface.

Lock type Applies to
OlapLockRead Applications can read the properties of the command object from the repository but cannot make changes until the lock is released (this includes the application that created the lock).
OlapLockWrite The application that created the lock can modify the object's properties and save them in the repository using the Update method. Other applications cannot read the properties of the object until the lock is released.

For more information about object locking, see LockObject.

Example

The following example locks a command object so that it can be modified. It then unlocks the object and updates the repository information for that object.

'Assume a command object (dsoCmd) exists.
dsoCmd.LockObect OlapLockRead, "Updating command, please wait."
' (Insert code to change command object here.)
dsoCmd.Update
dsoCmd.UnlockObject

See Also

Command Interface