> For the complete documentation index, see [llms.txt](https://sandbox-docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sandbox-docs.verifone.com/adk-5.0-programmers-guide/readme/files/dir_e65d4d0c0ba9865676ee3897978ecbf1/dir_517ad9dc307a0538d3e19e98627cc0af/dir_619a55c4c313d761d1f6a99da403e1c9/mac_8h.md).

# mac.h

[Namespaces](#namespaces) | [Macros](#define-members) | [Typedefs](#typedef-members) | [Enumerations](#enum-members) | [Functions](#func-members)

`#include <string>` `#include <vector>` `#include <map>` `#include <list>` `#include <`[ipc/jsobject.h](/adk-5.0-programmers-guide/ipc_2src_2ipc_2jsobject_8h_source.md)`>`

Include dependency graph for mac.h:

![](/files/fChQf9aEmVokAu8o2PeW)

This graph shows which files directly or indirectly include this file:

![](/files/JrFRbYPGpDfGWpCXjRaT)

[Go to the source code of this file.](/adk-5.0-programmers-guide/mac_8h_source.md)

|            |                                                                                   |
| ---------- | --------------------------------------------------------------------------------- |
| Namespaces |                                                                                   |
|            | [vfimac](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md) |

|         |                                                |
| ------- | ---------------------------------------------- |
| Macros  |                                                |
| #define | [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) |

|                 |                                                                                                                                                                                                                                                                                          |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Typedefs        |                                                                                                                                                                                                                                                                                          |
| typedef void(\* | [macEventCallback](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#aa740ccdb24bc2dad5717ef65e33b0a24)) (macEvent event, const [vfiipc::JSObject](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfiipc_1_1_j_s_object.md) \&json) |
| typedef void(\* | [macNotificationCallback](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#ad2df18eb227eae3f9524fa9031c92d4a)) (macNotifications notification)                                                                                                                    |

|              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enumerations |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| enum         | <p><a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216c">macError</a> {<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cae7c1d68ad552537bb450a291714bc71f">MAC\_ERR\_OK</a> = 0, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cab6a630bc98f5fcfa5a70e994171e514a">MAC\_ERR\_FAIL</a> = -1, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca3fe164f68d4f87b4e82dc481ea0516f6">MAC\_ERR\_UNSUPPORTED</a> = -2, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca25189ddd505007eeface48fa0f6336e2">MAC\_ERR\_LOCKED</a> = -3,<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216caaad631494e81b88687cb7a360f623524">MAC\_ERR\_TIMEOUT</a> = -4, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca48bc15eb2d9bc14d089714e680ec462f">MAC\_ERR\_LIBNOTIFY</a> = -5, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca2b3e6bb894a825d49a856f7d78fbaace">MAC\_ERR\_APP\_NOT\_RUNNING</a> = -6, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca6bc9cec21645bb6cc7dedc85598ad726">MAC\_ERR\_WRONG\_APPID</a> = -7,<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca13ecf9a9db7593cabe3ca09c3496c17b">MAC\_ERR\_NOT\_CP\_APP</a> = -8, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca95e3d004d001f47819fc6899a3f3c534">MAC\_ERR\_UNKNOWN</a> = -9, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca388507f8c281d588adfecda0ea957dae">MAC\_ERR\_CYCLE</a> = -10, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216caeb1198ea1741ae185ba82873527fc923">MAC\_ERR\_DEPENDS</a> = -11,<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cada88f95b27c2d275512fe15b4c54c2dd">MAC\_ERR\_MANIFEST</a> = -12, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca2a66718018e9604e11409a6bb0d9ee32">MAC\_ERR\_IPC</a> = -13, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca0514be0a87ce110f34cd00b756520654">MAC\_ERR\_NO\_APP</a> = -14, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216caeb10ef35a775f680b9576a0696c2c2de">MAC\_ERR\_READY</a> = -15,<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cab1f9a71117ad2514a34c858c5cb47578">MAC\_ERR\_ACTIVE</a> = -16, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca7f94b5307c9aaa494682cb4a3a8f2e0d">MAC\_ERR\_STOP</a> = -17, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca9bb50ccba3958e9b7fda61d3ac05534c">MAC\_ERR\_NO\_APPID</a> = -18, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cad3bee99511a15c87676dd9f453ac02fb">MAC\_ERR\_PERMISSION</a> = -19,<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca12b59c43d38429cdcaeaa7b45461930c">MAC\_ERR\_SERVICE</a> = -20, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca0ed934fa7a34568e74061ef14dfe3958">MAC\_ERR\_VISIBLE</a> = -21, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216caf0bdc46094bdcbb96d29c4a145e2fd33">MAC\_ERR\_DISABLED</a> = -22, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca5237e9b1351d2f63ae61112253bbfc16">MAC\_ERR\_LAUNCH</a> = -23,<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cac8482ef81b09dd82e6d99dc35396e52c">MAC\_ERR\_RUNNING</a> = -24, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cad71447e193322aa3defb1b6cdc6f6d5e">MAC\_ERR\_LAYOUT</a> = -25, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca75777560e490e9383775482ac3bc245d">MAC\_ERR\_PARAMETER</a> = -26, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca8648e53c152517be3dcebfdfb17edb97">MAC\_ERR\_IGNORE</a> = -27,<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca495bae09e1bc1aa9559aa0f7ec8668c0">MAC\_ERR\_CANCELED</a> = -28, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cab4d8f261fbe38564274fbf83af83c640">MAC\_ERR\_EXISTS</a> = -29, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cac704a12dc011b3831433799ec080ee1d">MAC\_ERR\_NO\_KEYS</a> = -30, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216caa6268efb5a8546b5d46e3bb0e553177a">MAC\_ERR\_EXPECTED\_KEYS</a> = -31,<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cafb7c2c54548ff09323602f8a6376fd01">MAC\_ERR\_ACCESS</a> = -32, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca0d00af9e30df42f5d7c593092ae546eb">MAC\_ERR\_AVAILIBLE</a> = -33, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216cad1f788f290b62d4889261290c009f40a">MAC\_ERR\_CPR\_DISABLED</a> = -35, <a href="/pages/U0nENIoK7PXDegm83fTC#a343256ae5f150542a1f6a38fcaca216ca848645e2aa4af15a919ba84aa700afae">MAC\_ERR\_INVALID\_FORMAT</a> = -36<br>}</p> |
| enum         | [macLaunchParams](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a3d1d0138ae66b9a9e03ae518de7ecf63) { [NONE](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a3d1d0138ae66b9a9e03ae518de7ecf63ac157bdf0b85a40d2619cbc8bc1ae5fe2) = 0, [KEEP\_IN\_BACKGROUND](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a3d1d0138ae66b9a9e03ae518de7ecf63a365b0d10413f98eb889815324f8baa8c) = 1 }                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| enum         | <p><a href="/pages/U0nENIoK7PXDegm83fTC#a7ecd7d8b8c98bd60b3a7d95dc5da7c5f">macKeyboard</a> {<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a7ecd7d8b8c98bd60b3a7d95dc5da7c5fadbb3aeb300a8742e67f13bf86222792c">MAC\_KBD\_OFF</a> = (0<<0), <a href="/pages/U0nENIoK7PXDegm83fTC#a7ecd7d8b8c98bd60b3a7d95dc5da7c5fa55c180fc86b4f765cabde2dd43046205">MAC\_KBD\_ON</a> = (1<<0), <a href="/pages/U0nENIoK7PXDegm83fTC#a7ecd7d8b8c98bd60b3a7d95dc5da7c5fa1897eb426573ca469062c0af6ffe0db2">MAC\_KBD\_AUTO</a> = (1<<1), <a href="/pages/U0nENIoK7PXDegm83fTC#a7ecd7d8b8c98bd60b3a7d95dc5da7c5fa70f8a1ce4507a2faab7727edee56f25b">MAC\_KBD\_NUMERIC</a> = (1<<2),<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a7ecd7d8b8c98bd60b3a7d95dc5da7c5faacf7fd09da851474c48e57ae2b9246d5">MAC\_KBD\_ALPHANUMERIC</a> = (1<<3), <a href="/pages/U0nENIoK7PXDegm83fTC#a7ecd7d8b8c98bd60b3a7d95dc5da7c5fad6499892dc5c2341c9a29774e4a5b8ae">MAC\_KBD\_CAPITALIZED</a> = (1<<4), <a href="/pages/U0nENIoK7PXDegm83fTC#a7ecd7d8b8c98bd60b3a7d95dc5da7c5fa07083975a8682e89077a7d12fbad382d">MAC\_KBD\_LAST</a> = (1<<5)<br>}</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| enum         | <p><a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4b">macEvent</a> {<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4ba939a6cc6d749a232a23ff324dca6d48c">EVENT\_NONE</a> = 0, <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4baa4bcbb24c61f7b837ca19df0d94be56d">EVENT\_MANIFEST\_UPDATE</a> = 1, <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4ba5d88b096adf1cb668ea2c1bf0d8e8cb8">EVENT\_ACTIVATION\_UPDATE</a> = 2, <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4ba7e6a2f51239e12672d2809ee6f07e177">EVENT\_PARAMETER\_UPDATE</a> = 3,<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4ba5e22fbb3d7e11c749b90e3b0461681fb">EVENT\_FOCUS\_UPDATE</a> = 4, <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4ba5919ad4670c8e825ad53aba144805df5">EVENT\_FOREGROUND</a> = 5, <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4bac8f0e13a5042856ad22cc0ba40ac5062">EVENT\_BACKGROUND</a> = 6, <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4ba4ca989c23c081528027d2838adda4010">EVENT\_CP\_STARTED</a> = 7,<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4bae4b2096693e8230bf7e8234bffeb7ba3">EVENT\_CP\_STOPPED</a> = 8, <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4bad928ed1a71b92636907ab3b1738c0b22">EVENT\_BOOT\_COMPLETED</a> = 9, <a href="/pages/U0nENIoK7PXDegm83fTC#a3bc43cdb5f4033e625bb6dc7e1579d4ba9266ca0adff9ab315332fb237ddfed81">EVENT\_LAST</a> = 10<br>}</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| enum         | <p><a href="/pages/U0nENIoK7PXDegm83fTC#aabd24d8a0b08ebc6a6da2c43b0ae2d9b">macNotifications</a> {<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#aabd24d8a0b08ebc6a6da2c43b0ae2d9ba5cc432d77c6eb1abbe3f89d4f895f778">NOTIFICATION\_NONE</a> = (0<<0), <a href="/pages/U0nENIoK7PXDegm83fTC#aabd24d8a0b08ebc6a6da2c43b0ae2d9ba6e467da2577048534d2368040c31d17e">NOTIFICATION\_MANIFEST\_RESCAN</a> = (1<<0), <a href="/pages/U0nENIoK7PXDegm83fTC#aabd24d8a0b08ebc6a6da2c43b0ae2d9ba923a1344f83663f39ac04c4ec3d745d9">NOTIFICATION\_ACTIVATION\_CFG\_UPDATE</a> = (1<<1), <a href="/pages/U0nENIoK7PXDegm83fTC#aabd24d8a0b08ebc6a6da2c43b0ae2d9ba95a27537b51afc0c265c453ada39d055">NOTIFICATION\_PARAMETER\_CFG\_UPDATE</a> = (1<<2),<br>  <a href="/pages/U0nENIoK7PXDegm83fTC#aabd24d8a0b08ebc6a6da2c43b0ae2d9badd8eec9dc45ce42675de6bda75ab3619">NOTIFICATION\_CP\_START</a> = (1<<3), <a href="/pages/U0nENIoK7PXDegm83fTC#aabd24d8a0b08ebc6a6da2c43b0ae2d9bac0ebe51801843ebdb451ae7a36d4f2cb">NOTIFICATION\_CP\_STOP</a> = (1<<4), <a href="/pages/U0nENIoK7PXDegm83fTC#aabd24d8a0b08ebc6a6da2c43b0ae2d9ba29e9cf6282fd10a8fb52f46d21c482c2">NOTIFICATION\_LAST</a> = (1<<6), <a href="/pages/U0nENIoK7PXDegm83fTC#aabd24d8a0b08ebc6a6da2c43b0ae2d9ba1930c35d6489778ddfeaca7fb2ca6f5e">NOTIFICATION\_ALL</a> = 0xFFFF<br>}</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| enum         | [systemNotificationPriority](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#af8d28bc2c3fa0398b42f840088f59a4b) { [SYSTEM\_NOTIFICATION\_INFO](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#af8d28bc2c3fa0398b42f840088f59a4bae45a50bf56795bda968dfc1694ad2871) = 1, [SYSTEM\_NOTIFICATION\_WARNING](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#af8d28bc2c3fa0398b42f840088f59a4ba4313068313501b2088a0336442126a4a) = 2, [SYSTEM\_NOTIFICATION\_CRITICAL](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#af8d28bc2c3fa0398b42f840088f59a4ba6951f9532ee21d9a68bf0e4f1307d03b) = 3 }                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |

|                                                              |                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Functions                                                    |                                                                                                                                                                                                                                                                                                                                                                 |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysSetEventCallback](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#ae4108c74c16f2f512405ba326843109a) (macEvent event, macEventCallback cb)                                                                                                                                                                                          |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysNotificationCallback](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a21f532b6bb03873e6927390c19840c67) (macNotificationCallback cb, long notification\_mask)                                                                                                                                                                      |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysNotificationCallback](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#adb02617beacae56d66f518a263ce0890) (macNotificationCallback cb=NULL, macNotifications notification=NOTIFICATION\_NONE)                                                                                                                                        |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysShowDesktop](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a404d8e38300385724b2d2ed306df863e) ()                                                                                                                                                                                                                                  |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysShowControlPanel](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a395a73335aa92641a3ac0967fc0bb200) ()                                                                                                                                                                                                                             |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysShowPowerControlPanel](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a085b2f637d5f82e4ee2812baf24eba46) ()                                                                                                                                                                                                                        |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysShowPrevApp](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a40e24a74e4f3dc63f080b34b0bb6c7de) ()                                                                                                                                                                                                                                  |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLaunchAppid](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a77748eeae43d8b50145564d0022ad886) (const std::string \&appid, const std::vector< std::string > \&args, const std::map< std::string, std::string > \&envs, int params=0)                                                                                               |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLaunchAppid](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a17fee224cba3c5bfaf8835fbda157cc3) (const std::string \&appid, const std::vector< std::string > \&args, int params)                                                                                                                                                    |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLaunchAppid](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a53a3ccda2cdc2d39f2c618015ea81efb) (const std::string \&appid, const std::vector< std::string > \&args)                                                                                                                                                                |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLaunchAppid](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#aa3c091d3bd20d0131c5f50318cd0750e) (const std::string \&appid)                                                                                                                                                                                                         |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLaunchApp](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a52ed11c68234a6abcf53fa5edd596729) (const std::string \&appname, const std::vector< std::string > \&args)                                                                                                                                                                |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLaunchApp](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a5b1e0d2f61a93565ac1f1f2d89d4caf3) (const std::string \&appname)                                                                                                                                                                                                         |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysRelaunchApps](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a5b63071e5232000be8cd04e2950b28b2) ()                                                                                                                                                                                                                                 |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysIsRunning](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#aae05286692566c22ef2d18a69748c5fe) (const std::string \&appid, bool \&running)                                                                                                                                                                                           |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysShowProgress](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#abb5ddef3187ac018cda433a3aec2c6fb) (const std::string \&info, size\_t percent)                                                                                                                                                                                        |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysSetAppid](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#abcf911819fbee784ef245fe34aa9572c) (const std::string \&appid)                                                                                                                                                                                                            |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysUnSetAppid](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a738e18eb97f53b402e01c6ee391b2607) ()                                                                                                                                                                                                                                   |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysChangeLayout](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#aa54bee100e8df7bab8868a0c6b81bc67) (const std::string \&layoutname, bool statusbar=true, bool keyboard=false)                                                                                                                                                         |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysChangeLayout](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a868378044b45895f8c85d0530c482a9e) (const std::string \&layoutname, bool statusbar)                                                                                                                                                                                   |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysAssignToLayout](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#aad01e467699aabea2fa64b588ede1fec) (const std::string \&appid, const std::string \&region)                                                                                                                                                                          |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysFullscreenMode](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a56bd229ab93be9b2ee7ae2f95d10c166) (bool enable)                                                                                                                                                                                                                    |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysStatusbar](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a9c942ac576c34a0e8dbd8cd69935a807) (bool visible)                                                                                                                                                                                                                        |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysGetCPRState](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a924f920dc0fd9b34e91c6e57bd97816c) (bool \&active)                                                                                                                                                                                                                     |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysGetCPAppRootDir](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a0d95ca7aac6a37040b0e2135d9f134d1) (std::string \&path)                                                                                                                                                                                                            |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysGetWMState](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#ad031802bca1577454ee78a31122bde6d) (bool \&active)                                                                                                                                                                                                                      |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysStatusbarState](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#ac3325831385c4e7755c3d96575db9496) (bool \&visible)                                                                                                                                                                                                                 |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysSetStatusbarValues](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a6c72ec8391307ac42e3c9d044eac36e2) (const std::map< std::string, std::string > \&values)                                                                                                                                                                        |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysGetStatusbarValues](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a443df02ff6897b4a9e6cb5973f5842b2) (std::map< std::string, std::string > \&values)                                                                                                                                                                              |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysStatusbarRefresh](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a6f771d3743e177bce7b7d79c26cf3036) ()                                                                                                                                                                                                                             |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysVirtualKeyboard](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a287906c2724d813bb1eb0ad1f3b4f18a) (macKeyboard mode)                                                                                                                                                                                                              |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysVirtualKeyboard](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#acb5c31824823ba4b9708f41f86a3e4f0) (int mode)                                                                                                                                                                                                                      |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLockLayout](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a1f0513c597f95e860f0d4e516d72b364) (bool enable)                                                                                                                                                                                                                        |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysInForeground](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a438d8362980527e345759c52a2615071) (std::string \&appid)                                                                                                                                                                                                              |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysInForeground](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#afd762089e189223f837321ceb76ba9ba) (bool \&visible)                                                                                                                                                                                                                   |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysToForeground](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a424b735dc0296a43429f6dfeab802fa4) (const std::string \&appid)                                                                                                                                                                                                        |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysToForground](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a1ac2b7ae5456bc7a0e543804f92f890a) (const std::string \&appid)                                                                                                                                                                                                         |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysStopAppid](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a57f7a1edb91c7479e4c2b2916a252822) (const std::string \&appid)                                                                                                                                                                                                           |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysStopAppname](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a54ba5d09eeee6974f08950ae922c1896) (const std::string \&appname)                                                                                                                                                                                                       |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysStopAllUserApps](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a6b24cb5e42ba92f571a4f000e2ed0230) ()                                                                                                                                                                                                                              |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysStopOtherApps](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#ad5c53e66bd56f6368628fbbeaa514622) ()                                                                                                                                                                                                                                |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysGetAppList](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a807e4d61017fe99f6f6c66a8bd37ad08) ([vfiipc::JSObject](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfiipc_1_1_j_s_object.md) \&applist)                                                                                               |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysScanManifests](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#aec38c483c58974ddb58d576d9f7ac2f0) ()                                                                                                                                                                                                                                |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysSetCPEnvData](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a3cb1620e29b7920b2b53560c1cae71fe) (const [vfiipc::JSObject](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfiipc_1_1_j_s_object.md) \&envs)                                                                                          |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysInstallCPApp](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a86f520239eb2af7b49b1bc31dfc20906) (const std::string \&path)                                                                                                                                                                                                         |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLaunchCPAppFromDesktop](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a509d985b46d2fe8d772bd749888fd1ab) (const std::string \&trigger\_id, const std::vector< std::string > \&param)                                                                                                                                              |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLaunchCPAppFromDesktop](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a188f9500b7eff15c4e9761c26b7e6641) (const std::string \&trigger\_id, const [vfiipc::JSObject](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfiipc_1_1_j_s_object.md) \&param)                                              |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLaunchCPAppFromDesktopSync](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#aff611b7f21a2748fdc138db0718a481b) (const std::string \&trigger\_id, const [vfiipc::JSObject](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfiipc_1_1_j_s_object.md) \&param, int flags=0)                             |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysLaunchCPAppByTrigger](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a86cff41093ff1ab578ff1c54f47c5062) (const std::string \&appid, const std::string \&trigger\_id, const [vfiipc::JSObject](https://github.com/verifoneone/verifone-git-book-adk/tree/ADK5.0_staging/classvfiipc_1_1_j_s_object.md) \&param, unsigned int flags) |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysInvokeCPAppAction](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a45f53838cafde90263046e5844717399) (const std::string \&appid, const std::string \&name, int display\_id=0, unsigned int flags=0)                                                                                                                                |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysGetGUIRegionId](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a5a32e6fc3ca601108ec200e0bebf10a1) (const std::string \&appid, int \&gui\_region\_id)                                                                                                                                                                               |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [sysStopAllCPApps](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a9dea7108a3a1efc9a1cc087e18548c59) ()                                                                                                                                                                                                                                |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) int           | [systemNotificationAdd](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#ac4a12edca6083bfb03386f390d67bc3d) (systemNotificationPriority p, const std::string \&message, bool sticky=false)                                                                                                                                               |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [systemNotificationRemove](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a4aa74ec3d2bd8a53334045452b21820f) (int id)                                                                                                                                                                                                                  |
| [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) macError      | [systemNotificationList](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a49a2afa866d86f54ab20603abcb7eb45) (std::list< int > \&list)                                                                                                                                                                                                   |
| const [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) char \* | [sysMac\_GetVersion](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a2e646f58a5f98e1b01ccae0a576ab8cf) ()                                                                                                                                                                                                                              |
| const [MAC\_API](#a8794217925bb13f504792c2e3669bf4b) char \* | [sysLibMac\_GetVersion](/adk-5.0-programmers-guide/readme/modules/group__mac/namespacevfimac.md#a9145ab384964062fa95dd07ad6cc7480) ()                                                                                                                                                                                                                           |

### MacroDefinition Documentation <a href="#macro-definition-documentation" id="macro-definition-documentation"></a>

### MAC\_API <a href="#a8794217925bb13f504792c2e3669bf4b" id="a8794217925bb13f504792c2e3669bf4b"></a>

\#define MAC\_API

Marks public MAC API


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://sandbox-docs.verifone.com/adk-5.0-programmers-guide/readme/files/dir_e65d4d0c0ba9865676ee3897978ecbf1/dir_517ad9dc307a0538d3e19e98627cc0af/dir_619a55c4c313d761d1f6a99da403e1c9/mac_8h.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.