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:

PartDescription
objectAn 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.