SomMainProgram: Difference between revisions
No edit summary |
mNo edit summary |
||
| Line 3: | Line 3: | ||
==Syntax== | ==Syntax== | ||
SOMClassMgr *rc; | |||
SOMClassMgr *rc; | rc = somMainProgram(); | ||
rc = somMainProgram(); | |||
==Return Code== | ==Return Code== | ||
| Line 14: | Line 10: | ||
==Remarks== | ==Remarks== | ||
This function informs SOM about the beginning of a new thread of execution (called a task on Windows). The SOM Kernel then performs any needed initialization, including the deferred execution of the SOMInitModule functions found in statically-loaded class libraries. This function must appear near the beginning of all Windows main programs, and may also be used in AIX or OS/2 programs. When used, it supersedes any need to call the somEnvironmentNew function | This function informs SOM about the beginning of a new thread of execution (called a task on Windows). The SOM Kernel then performs any needed initialization, including the deferred execution of the SOMInitModule functions found in statically-loaded class libraries. This function must appear near the beginning of all Windows main programs, and may also be used in AIX or OS/2 programs. When used, it supersedes any need to call the somEnvironmentNew function. | ||
A convenience macro, SOM_MainProgram, which combines the execution of this function with the scheduling of the somEnvironmentEnd function during normal program termination, is available for C and C++ programmers. | |||
==Related== | ==Related== | ||
;Functions | |||
* [[somEnvironmentNew]] | * [[somEnvironmentNew]] | ||
* [[somEnvironmentEnd]] | * [[somEnvironmentEnd]] | ||
;Macros | |||
* [[SOM_MainProgram]] | * [[SOM_MainProgram]] | ||
* [[SOM_ClassLibrary]] | * [[SOM_ClassLibrary]] | ||
[[Category:SOM Kernel]] | [[Category:SOM Kernel]] | ||
Revision as of 16:48, 14 February 2020
This function performs SOM initialization on behalf of a new program.
Syntax
SOMClassMgr *rc; rc = somMainProgram();
Return Code
- rc (SOMClassMgr *)
- A pointer to the SOMClassMgr object.
Remarks
This function informs SOM about the beginning of a new thread of execution (called a task on Windows). The SOM Kernel then performs any needed initialization, including the deferred execution of the SOMInitModule functions found in statically-loaded class libraries. This function must appear near the beginning of all Windows main programs, and may also be used in AIX or OS/2 programs. When used, it supersedes any need to call the somEnvironmentNew function.
A convenience macro, SOM_MainProgram, which combines the execution of this function with the scheduling of the somEnvironmentEnd function during normal program termination, is available for C and C++ programmers.
Related
- Functions
- Macros