How to Release a Lock on a SEDO-Enabled Object

To Release an Explicit Lock on a SEDO-enabled Object

1. Create an instance of the SMS_ObjectLock WMI class

2. Get the method parameters object for the ReleaseLock method.

3. Assign the object path of the object you wish to unlock to the ObjectRelPath property.

4. Create an InvokeMethodOptions object instance. On the Context property, add a name/value pair. The name must be "MachineName" and the value must be name of the computer releasing the lock. For more information, see How to Acquire a Lock on a SEDO-Enabled Object

5. Call InvokeMethod on the SMS_ObjectLock instance.

6. InvokeMethod will return a SMS_ObjectLockRequest instance. Check the RequestState and LockState properties to get more information on the success or failure of the request.

Example

The following example releases a lock on a SMS_ConfigurationItem object instance.

class Program
{
    static void Main(string[] args)
    {
        ManagementScope scope = new ManagementScope(@"\siteservername\root\sms\site_ABC");
        ReleaseLock(scope);
    }

    public static void ReleaseLock(ManagementScope scope)
    {
        ManagementPath path = new ManagementPath("SMS_ObjectLock");
        ManagementClass objectLock = new ManagementClass(scope, path, null);

        ManagementBaseObject inParams = objectLock.GetMethodParameters("ReleaseLock");
        inParams["ObjectRelPath"] = "SMS_ConfigurationItem.CI_ID=30";

        InvokeMethodOptions options = new InvokeMethodOptions();
        options.Context.Add("MachineName", "RequestingComputer");

        ManagementBaseObject result = objectLock.InvokeMethod("ReleaseLock", inParams, options);

    }
}

The SMS_ObjectLockRequest object contains the following properties:

RequestState The table below displays the possible request state values. Request states Granted, GrantedAfterTimeout and GrantedLockWasOrphaned indicate a successful request and the user can then make and save modifications to the object. All other requests indicate error.

LockState The table below displays the possible lock state values.

Compiling the Code

The C# example requires:

Namespaces

System

System.Management

Assembly

Robust Programming

For more information about error handling, see About Configuration Manager Errors.

See Also

Configuration Manager SEDO