IoMgrLockLeave (FUN)

FUNCTION IoMgrLockLeave : RTS_IEC_RESULT

This function releases the mutual-exclusion locks (that were acquired with the function IoMgrLockEnter()) for the given operations.

IMPLEMENTATION NOTE: The behavior of the dwLockScope parameter can’t be implemented on all platforms. Platforms without synchronization functionality may not be able to implement this behavior. IoMgrEmbedded of the CODESYSControlEmbedded runtime system for example can only disable and enable all interrupts.

InOut:

Scope

Name

Type

Comment

Return

IoMgrLockLeave

RTS_IEC_RESULT
error code

  • ERR_OK: Locks were successfully released.

  • ERR_PARAMETER: The pbyIoDrv parameter is NULL (only implementations that use this parameter), or the dwLockScope parameter has none of the GVL LockScopes set (only implementations that use this parameter).

  • ERR_FAILED: No driver entry for pbyIoDrv found in device pool.

Input

hIoDrv

RTS_IEC_HANDLE

Handle to the driver instance which is returned by the function IoMgrRegisterInstance2().

dwLockScope

DWORD

The operations for which to release the locks. See GVL LockScopes for detailed information.