CRTThreadTraits Class

  • Article

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at CRTThreadTraits Class.

This class provides the creation function for a CRT thread. Use this class if the thread will use CRT functions.

Important

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

Syntax

class CRTThreadTraits

Members

Public Methods

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

Remarks

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.

Requirements

Header: atlbase.h

CRTThreadTraits::CreateThread

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.

See Also

Class Overview