WinQuerySystemAtomTable: Difference between revisions
Appearance
mNo edit summary |
No edit summary |
||
Line 5: | Line 5: | ||
==Returns== | ==Returns== | ||
; | ;hatomtblAtomTbl (HATOMTBL) - returns : System atom-table handle. | ||
==Remarks== | |||
The system atom table can be accessed by any process in the system. It is created at boot time and cannot be destroyed. | |||
==Example Code== | |||
<pre> | |||
#define INCL_WINATOM /* Or use INCL_WIN, INCL_PM, */ | |||
#include <os2.h> | |||
HATOMTBL hatomtblAtomTbl; /* System atom-table handle. */ | |||
hatomtblAtomTbl = WinQuerySystemAtomTable(); | |||
</pre> | |||
This function queries the length of an atom. | |||
<pre> | |||
#define INCL_WINATOM | |||
#include <OS2.H> | |||
HATOMTBL hatomtbl; | |||
ATOM atom; | |||
unsigned char szAtomName; | |||
hatomtbl = WinQuerySystemAtomTable(); | |||
atom = WinFindAtom(hatomtbl, &szAtomName); | |||
</pre> | |||
==Related Functions== | |||
* [[WinAddAtom]] | |||
* [[WinCreateAtomTable]] | |||
* [[WinDeleteAtom]] | |||
* [[WinDestroyAtomTable]] | |||
* [[WinFindAtom]] | |||
* [[WinQueryAtomLength]] | |||
* [[WinQueryAtomName]] | |||
* [[WinQueryAtomUsage]] | |||
* [[WinQuerySystemAtomTable]] | |||
[[Category:Win]] | [[Category:Win]] |
Revision as of 04:07, 6 April 2025
Retrieves a handle to the system atom table
Syntax
WinQuerySystemAtomTable ()
Returns
- hatomtblAtomTbl (HATOMTBL) - returns
- System atom-table handle.
Remarks
The system atom table can be accessed by any process in the system. It is created at boot time and cannot be destroyed.
Example Code
#define INCL_WINATOM /* Or use INCL_WIN, INCL_PM, */ #include <os2.h> HATOMTBL hatomtblAtomTbl; /* System atom-table handle. */ hatomtblAtomTbl = WinQuerySystemAtomTable();
This function queries the length of an atom.
#define INCL_WINATOM #include <OS2.H> HATOMTBL hatomtbl; ATOM atom; unsigned char szAtomName; hatomtbl = WinQuerySystemAtomTable(); atom = WinFindAtom(hatomtbl, &szAtomName);