UnlockServiceDatabase

The UnlockServiceDatabase function unlocks a service control manager database by releasing the specified lock.

BOOL UnlockServiceDatabase(
  SC_LOCK ScLock   // service control manager database lock to be 
                   // released
);
 

Parameters

ScLock
Specifies a lock obtained from a previous call to the LockServiceDatabase function.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Errors

The following error codes can be set by the service control manager. Other error codes can be set by the registry functions that are called by the service control manager.

Value Meaning
ERROR_INVALID_SERVICE_LOCK The specified lock is invalid.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winsvc.h.
  Import Library: Use advapi32.lib.

See Also

Services Overview, Service Functions, LockServiceDatabase, QueryServiceLockStatus