CRTThreadTraits Class

 

For the latest documentation on Visual Studio 2017, see Visual Studio 2017 Documentation.

For the latest documentation on Visual Studio 2017, see CRTThreadTraits Class on docs.microsoft.com. This class provides the creation function for a CRT thread. Use this class if the thread will use CRT functions.

System_CAPS_ICON_important.jpg Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

class CRTThreadTraits

Public Methods

NameDescription
CRTThreadTraits::CreateThread(Static) Call this function to create a thread that can use CRT functions.

Thread traits are classes that provide a creation function for a particular type of thread. The creation function has the same signature and semantics as the Windows CreateThread function.

Thread traits are used by the following classes:

If the thread will not be using CRT functions, use Win32ThreadTraits instead.

Header: atlbase.h

Call this function to create a thread that can use CRT functions.

static HANDLE CreateThread(
    LPSECURITY_ATTRIBUTES lpsa,
    DWORD dwStackSize,
    LPTHREAD_START_ROUTINE pfnThreadProc,
    void* pvParam,
    DWORD dwCreationFlags,
    DWORD* pdwThreadId) throw();

Parameters

lpsa
The security attributes for the new thread.

dwStackSize
The stack size for the new thread.

pfnThreadProc
The thread procedure of the new thread.

pvParam
The parameter to be passed to the thread procedure.

dwCreationFlags
The creation flags (0 or CREATE_SUSPENDED).

pdwThreadId
[out] Address of the DWORD variable that, on success, receives the thread ID of the newly created thread.

Return Value

Returns the handle to the newly created thread or NULL on failure. Call GetLastError to get extended error information.

Remarks

See CreateThread for further information on the parameters to this function.

This function calls _beginthreadex to create the thread.

Class Overview

Show: