Jump to content

WinQuerySystemAtomTable: Difference between revisions

From EDM2
Ak120 (talk | contribs)
mNo edit summary
No edit summary
Line 5: Line 5:


==Returns==
==Returns==
;rc (HATOMTBL)
;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);

Related Functions