Description
Creates a McDBNode Write Lock on the Node.
-
Return Type
-
An Integer value. A Integer with value LockNode count.
Failure Returns -1..
-
Syntax
-
object.LockNode
The LockNode Method syntax has these parts:
|
| object | An expression evaluating to an object of type McDataNodeRef. |
Remarks
While the Node is locked no other clients will be able to modify it.
Under normal circumstances this function should only be used when
.LockNodeMode = mcdatNRLOptimistic. The Lock will be released when the
Node is released. A Reference counter is retained to manage multiple LockNode / UnLockNode calls.
See UnLockNode.
Exceptions
E_INVALIDARG: LockNodeMode = mcdatNRLNone. E_INVALIDARG: IsEmpty = True E_ACCESSDENIED: ReferenceActivate() = False ERROR_TIMEOUT: mcdatNRLOptimistic lock timed out. ERROR_LOCK_FAILED: For each cycle of mcdatNRLOptimistic lock attempt (See ErrorInfo and Notifications). Propagated: .LockMode ERROR_NOTIFY_ENUM_DIR: Lock may not be perform because Node has changed. Call Refresh or SetNode.