Click here to Skip to main content
13,006,360 members (75,534 online)
Click here to Skip to main content
Add your own
alternative version


24 bookmarked
Posted 18 Apr 2003

Win32 Worker Thread Wrapper

, 18 Apr 2003
Rate this:
Please Sign up or sign in to vote.
Win32 Worker Thread Wrapper
<!-- Article image -->

Sample Image - demo.jpg

<!-- Add the rest of your HTML here -->


Windows is an OS that does a "great job" of pretending to be a multitasking environment, so it would be a shame, if we programmers would not use this feature at least just for fun. This class should bring you this fun, and maybe (I hope) some knowledge. The class CAG_Thread is just another win32 worker thread wrapper class. Yes, I am sure you could find many other classes that would do the same job just as fine or even better, but what I tried to accomplish is the simplicity. But as we all know the simplicity is subjective, so I will let you judge it for yourself.


Some time ago I noticed that every once in a while I write a worker thread. Each time I need to write one, I copy and paste some functions, change them, and adjust them so they do the new job. After a while I got bored so I decided to write a class that would be very simple and still provide most common features used by me in a worker thread. So the class CAG_Thread was born.

Using the code

The class should be very simple to use. It is intended to be a base class for another class, because it contains the pure virtual function ThreadMain() which must be overridden. Here is the step by step use of the class:

  1. Include AG_Thread.cpp and AG_Thread.h into your project
  2. Derive a new class from CAG_Thread class
  3. Override in the new class the virtual function ThreadMain()
  4. Use the newly created class to instantiate and start the thread by StartThread() function

Here is more detailed explanation with sample code which could be downloaded at the top of the article. I will assume that you should know how to add files to project. Follwoing is the second step of deriving a new class, in my case myThread class from CAG_Thread class. Following is the myThread class definition.

#include "AG_Thread.h" 

class myThread : public CAG_Thread
 virtual ~myThread(); 

 // I provide this function to pass any kind of parameters
 BOOL Work(CProgressCtrl *pProgress); 

 // Progress control to show progress
 CProgressCtrl *m_pProgress; 

 // must override this function
 UINT ThreadMain();

And here is (partly) the  class implementation

BOOL myThread::Work(CProgressCtrl *pProgress)
 if(pProgress == NULL)
  return FALSE; 

 m_pProgress = pProgress; 

 return StartThread();

UINT myThread::ThreadMain()
 // init progress control
 m_pProgress->SetRange(0, 100);

 for(int i=0; i<101; ++i)
   return 1; 


 return 0;

Now we need to create instance of our class myThread in the dialog box and use it. I simply used a button for starting the thread, but it is not limited to dialog boxes. So here is the function where the starting and ending of the thread occurs.

// check is the thread running and if not then
// start it otherwise abort it
  AfxMessageBox(_T("Thread killed successfully!"));
  SetDlgItemText(IDC_START_STOP_BUTTON, _T("Start Thread"));

 AfxMessageBox(_T("Could not abort thread."));
  SetDlgItemText(IDC_START_STOP_BUTTON, _T("Stop Thread"));

 AfxMessageBox(_T("Could not start thread."));

And that should be it. The demo included is the very basic example of what this class is good for. Please note that this class does not provide any synchronization objects, with the purpose to be as simple as possible. Also the demo is not a useful application, it simply shows the principal of using the class. This article is not very detailed, which again should add to the simplicity, but the code should be documented enough. English is my third language, so if you do not understand something (and experience tells me that you will not), please leave a message and I'll try to answer.


This article, along with any associated source code and files, is licensed under The Apache License, Version 2.0


About the Author

Amer Gerzic
President Infinity Software Solutions, LLC.
United States United States
Originally from Bosnia and Herzegovina, but lived for 6 years in Germany where I did majority of education, then moved to US, where I live since 1999. I like programming, computers in general, but also Basketball, Soccer, Tennis, and many other things. Masters graduate from Grand Valley State University in CIS and working as a full time software developer. Please visit my website

You may also be interested in...

Comments and Discussions

Questionnice work Pin
smart_dummies18-Feb-14 19:09
membersmart_dummies18-Feb-14 19:09 
GeneralCool stuff Pin
Nedim Sabic23-Nov-08 23:44
memberNedim Sabic23-Nov-08 23:44 
GeneralRe: Cool stuff Pin
Amer Gerzic24-Nov-08 2:53
memberAmer Gerzic24-Nov-08 2:53 
GeneralAn alternative view Pin
Mizan Rahman21-Jul-08 1:39
memberMizan Rahman21-Jul-08 1:39 
GeneralRe: An alternative view Pin
Amer Gerzic21-Jul-08 2:33
memberAmer Gerzic21-Jul-08 2:33 
Questionwhat about function for chagin thread priority Pin
winxalex24-Sep-03 1:36
memberwinxalex24-Sep-03 1:36 
AnswerRe: what about function for chagin thread priority Pin
Amer Gerzic24-Sep-03 2:22
memberAmer Gerzic24-Sep-03 2:22 
GeneralRe: what about function for chagin thread priority Pin
winxalex24-Sep-03 4:32
memberwinxalex24-Sep-03 4:32 
GeneralRe: what about function for chagin thread priority Pin
Amer Gerzic24-Sep-03 7:46
memberAmer Gerzic24-Sep-03 7:46 
QuestionHow can i check that the thread is done ? Pin
Sickboy17-Sep-03 10:54
memberSickboy17-Sep-03 10:54 
AnswerRe: How can i check that the thread is done ? Pin
Amer Gerzic18-Sep-03 1:59
memberAmer Gerzic18-Sep-03 1:59 
GeneralRe: How can i check that the thread is done ? Pin
Sickboy18-Sep-03 7:08
memberSickboy18-Sep-03 7:08 
GeneralRe: How can i check that the thread is done ? Pin
Amer Gerzic18-Sep-03 9:47
memberAmer Gerzic18-Sep-03 9:47 
GeneralInteresting! Pin
WREY30-Apr-03 14:06
memberWREY30-Apr-03 14:06 
GeneralRe: Interesting! Pin
Amer Gerzic1-May-03 1:54
memberAmer Gerzic1-May-03 1:54 
GeneralRe: Interesting! Pin
WREY1-May-03 11:13
memberWREY1-May-03 11:13 
GeneralRe: Interesting! Pin
Amer Gerzic2-May-03 1:44
memberAmer Gerzic2-May-03 1:44 
GeneralCThread by Bjarke Viksoe Pin
Stanislav Panasik20-Apr-03 19:02
sussStanislav Panasik20-Apr-03 19:02 
GeneralRe: CThread by Bjarke Viksoe Pin
Amer Gerzic21-Apr-03 2:05
memberAmer Gerzic21-Apr-03 2:05 
GeneralATL Thread Classes Pin
mdgray19-Apr-03 18:28
membermdgray19-Apr-03 18:28 
GeneralRe: ATL Thread Classes Pin
Amer Gerzic20-Apr-03 7:25
memberAmer Gerzic20-Apr-03 7:25 
GeneralRe: ATL Thread Classes Pin
mdgray20-Apr-03 13:59
membermdgray20-Apr-03 13:59 
GeneralNice! Pin
Daniel Lohmann19-Apr-03 13:36
memberDaniel Lohmann19-Apr-03 13:36 
GeneralRe: Nice! Pin
Amer Gerzic20-Apr-03 5:42
memberAmer Gerzic20-Apr-03 5:42 
GeneralRe: Nice! Pin
Daniel Lohmann20-Apr-03 10:54
memberDaniel Lohmann20-Apr-03 10:54 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.170628.1 | Last Updated 19 Apr 2003
Article Copyright 2003 by Amer Gerzic
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid