CONFIG += link_pkgconfig
 PKGCONFIG += sailfishmdm

 #include <mdm-devicelock.h>
 void setOrClearDeviceLock(bool lockout, QObject *parent)
 {
     Sailfish::Mdm::DeviceLock *lock = new Sailfish::Mdm:DeviceLock(parent);
     if (lockout) {
         lock->setLockoutMode(Sailfish::Mdm::DeviceLock::RecoverableManagerLockout);
         QObject::connect(lock, &Sailfish::Mdm::DeviceLock::lockoutModeChanged, [] {
             qInfo() << "Device locked";
         });
         QObject::connect(lock, &Sailfish::Mdm::DeviceLock::lockoutModeError, [] {
             qInfo() << "Failed to lock device";
         });
     } else {
         lock->setLockoutMode(Sailfish::Mdm::DeviceLock::NoManagerLockout);
         QObject::connect(lock, &Sailfish::Mdm::DeviceLock::lockoutModeChanged, []() {
             qInfo() << "Lockout cleared";
         });
         QObject::connect(lock, &Sailfish::Mdm::DeviceLock::lockoutModeError, []() {
             qInfo() << "Failed to clear lockout";
         });
     }
 }

Member Function Documentation

DeviceLock::DeviceLock(QObject *parent = nullptr)

Default constructs an instance of DeviceLock.

DeviceLock::~DeviceLock()

Destroys the instance of DeviceLock.

void DeviceLock::clearDevice(ClearOptions options = ShutdownAfterClear)

Attempts to clear the device according to the specified options.

This operation is asynchronous.

If successful, deviceCleared() will be emitted. Otherwise, clearDeviceError() will be emitted.

The following options may be specified: ShutdownAfterClear, RebootAfterClear, WipePartitions.

[signal] void DeviceLock::clearDeviceError()

This signal is emitted if an attempt to clear the device filesystem via a call to clearDevice() fails.

[signal] void DeviceLock::deviceCleared()

This signal is emitted once the device filesystem is cleared due to a call to clearDevice().

[signal] void DeviceLock::lockoutModeChanged()

This signal is emitted when the lock state of the device transitions to locked out, as a result of a call to setLockoutMode().

[signal] void DeviceLock::lockoutModeError()

This signal is emitted if a call to setLockoutMode() fails.

[signal] void DeviceLock::securityCodeChangeError()

This signal is emitted if a call to setSecurityCode() fails.

[signal] void DeviceLock::securityCodeChanged()

This signal is emitted once the security code for the device has been successfully changed as a result of a call to setSecurityCode().

void DeviceLock::setLockoutMode(ManagerLockoutMode mode, const QVariantMap &feedback = QVariantMap())

Attempts to change the device lock manager lockout state to mode.

This operation is asynchronous.

If successful, lockoutModeChanged() will be emitted. Otherwise, lockoutModeError() will be emitted.

A device in the ManagerLockout state cannot be unlocked except by the MDM client, the PermanentManagerLockout state cannot be removed ever.

The default feedback provided to the user when they are advised of the lockout can be overwritten by populating the feedback map. The following keys are supported:

• warning The warning text describing the reason for the lockout.

void DeviceLock::setSecurityCode(const QString &code)

Attempts to change the security code to the given code.

This operation is asynchronous.

If successful, securityCodeChanged() will be emitted. Otherwise, securityCodeChangeError() will be emitted.