`_beginthread`，`_beginthreadex`

项目
10/18/2023

创建线程。

语法

uintptr_t _beginthread( // NATIVE CODE
   void( __cdecl *start_address )( void * ),
   unsigned stack_size,
   void *arglist
);
uintptr_t _beginthread( // MANAGED CODE
   void( __clrcall *start_address )( void * ),
   unsigned stack_size,
   void *arglist
);
uintptr_t _beginthreadex( // NATIVE CODE
   void *security,
   unsigned stack_size,
   unsigned ( __stdcall *start_address )( void * ),
   void *arglist,
   unsigned initflag,
   unsigned *thrdaddr
);
uintptr_t _beginthreadex( // MANAGED CODE
   void *security,
   unsigned stack_size,
   unsigned ( __clrcall *start_address )( void * ),
   void *arglist,
   unsigned initflag,
   unsigned *thrdaddr
);

参数

start_address
启动开始执行新线程的例程的地址。对于 _beginthread，调用约定为 __cdecl（本机代码）或 __clrcall（托管代码）。对于 _beginthreadex，调用约定为 __stdcall（本机代码）或 __clrcall（托管代码）。

stack_size
新线程的堆栈大小或 0。

arglist
要传递到新线程的参数列表或 NULL。

Security
指向 SECURITY_ATTRIBUTES 结构的指针，此结构确定返回的句柄是否由子进程继承。如果 Security 为 NULL，则不能继承句柄。

initflag
控制新线程的初始状态的标志。将 initflag 设置为 0 以立即运行，或设置为 CREATE_SUSPENDED 以在挂起状态下创建线程；使用 ResumeThread 来执行此线程。将 initflag 设置为 STACK_SIZE_PARAM_IS_A_RESERVATION 标志以将 stack_size 用作堆栈的初始保留大小（以字节计）；如果未指定此标志，则 stack_size 将指定提交大小。

thrdaddr
指向接收线程标识符的 32 位变量。如果是 NULL，则不使用它。

返回值

如果成功，则这些函数中的每一个都会返回一个句柄到新创建的线程；但是，如果新创建的线程退出过快，则 _beginthread 可能不会返回有效句柄。（请参见“备注”部分中的讨论。）发生错误时，_beginthread 返回 -1L，并在线程过多的情况下将 errno 设置为 EAGAIN；如果参数无效或堆栈大小错误，则设置为 EINVAL；如果资源（如内存）不足，则设置为 EACCES。发生错误时， _beginthreadex 返回 0 并设置 errno 和 _doserrno 。

如果 start_address 为 NULL，则会调用无效的参数处理程序，如参数验证中所述。如果允许执行继续，则这些功能将 errno 设置为 EINVAL 并返回 -1。

有关这些和其他的返回代码的详细信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

有关 uintptr_t 的详细信息，请参阅标准类型。

注解

_beginthread 函数创建一个在 start_address处开始执行例程的线程。 start_address 处的例程必须使用 __cdecl （对于本机代码）或 __clrcall （对于托管代码）调用约定，且应没有任何返回值。当线程从该例程返回时，它会自动终止。有关线程的详细信息，请参阅针对旧代码的多线程支持 (Visual C++)。

与 _beginthread 相比，_beginthreadex 更类似于 Win32 CreateThread API。 _beginthreadex 与 _beginthread 的差别体现在以下方面：

_beginthreadex 还有三个参数：initflag、Security、threadaddr。新线程可通过指定的 security 创建为挂起状态，并且可使用线程标识符 thrdaddr进行访问。
start_address 处传递给 _beginthreadex 的例程必须使用 __stdcall （对于本机代码）或 __clrcall （对于托管代码）调用约定，并且必须返回线程退出代码。
如果失败，_beginthreadex 会返回 0，而不是 -1L。
使用 _beginthreadex 创建的线程已通过对 _endthreadex 的调用终止。

与 _beginthreadex 相比， _beginthread 让你可以在更大程度上控制如何创建线程。 _endthreadex 函数也更为灵活。例如，通过 _beginthreadex，你可以使用安全信息、设置线程的初始状态（运行或挂起）并获取新创建线程的线程标识符。你还可以将 _beginthreadex 返回的线程句柄与同步 API 结合使用，但无法通过 _beginthread 完成此操作。

使用 _beginthreadex 比 _beginthread 更安全。如果由 _beginthread 生成的线程很快退出，则返回到 _beginthread 调用方的句柄可能无效或指向另一个线程。但是，由 _beginthreadex 返回的句柄必须由 _beginthreadex 的调用方关闭，因此如果 _beginthreadex 未返回任何错误，则可以保证其为有效句柄。

可以显式调用 _endthread 或 _endthreadex 终止线程；但是，当线程从作为参数传递的例程中返回时，会自动调用 _endthread 或 _endthreadex。通过对 _endthread 或 _endthreadex 的调用来终止线程有助于确保正确恢复为线程分配的资源。

_endthread 会自动关闭线程句柄，而 _endthreadex 则不会。因此，当你使用 _beginthread 和 _endthread 时，不要通过调用 Win32 CloseHandle API 来显式关闭线程句柄。该行为与 Win32 ExitThread API 不同。

注意

对于与 Libcmt.lib 链接的可执行文件，请不要调用 Win32 ExitThread API，这样就不会阻止运行时系统回收已分配的资源。 _endthread 和 _endthreadex 回收分配的线程资源，然后调用 ExitThread。

当调用了 _beginthread 或 _beginthreadex 中的任一个时，操作系统将处理堆栈的分配；你不必将该线程堆栈的地址传递给这两个函数中的任何一个。此外， stack_size 参数还可为 0，在这种情况下，操作系统使用的值与为主线程指定的堆栈相同。

arglist 是传递到新创建的线程的参数。它通常是数据项的地址，例如字符串。 arglist 在不需要时可以为 NULL，但必须对 _beginthread 和 _beginthreadex 赋值才能传递到新线程。如果任何线程调用 abort、 exit、 _exit或 ExitProcess，所有线程都会终止。

新线程的区域设置通过使用每进程全局当前区域设置信息来初始化。如果通过对 _configthreadlocale 的调用（全局或仅针对新线程）启用了每线程区域设置，则线程可以通过调用 setlocale 或 _wsetlocale 独立从其他线程更改区域设置。没有设置每线程区域设置标志的线程可能会影响所有其他线程（包括也未设置每线程区域设置标志的线程，以及所有新创建的线程）中的区域设置信息。有关详细信息，请参阅 Locale。

对于 /clr 代码，_beginthread 和 _beginthreadex 都有两个重载。一个采用本机调用约定函数指针，另一个采用 __clrcall 函数指针。第一个重载不是应用程序域安全的且永远不会是。如果要编写 /clr 代码，则必须确保新线程在访问受管理资源之前进入正确的应用程序域。例如，可以使用 call_in_appdomain 来完成此操作。第二个重载是应用程序安全域；新创建的线程总是在 _beginthread 或 _beginthreadex调用方的应用程序域中结束。

默认情况下，此函数的全局状态范围限定为应用程序。要更改此行为，请参阅 CRT 中的全局状态。

要求

例程	必需的标头
`_beginthread`	`<process.h>`
`_beginthreadex`	`<process.h>`

有关兼容性的详细信息，请参阅兼容性。

库

仅限 C 运行库的多线程版本。

若要使用 _beginthread 或 _beginthreadex，应用程序必须与一个多线程 C 运行库链接。

示例

下面的示例使用 _beginthread 和 _endthread。

// crt_BEGTHRD.C
// compile with: /MT /D "_X86_" /c
// processor: x86
#include <windows.h>
#include <process.h>    /* _beginthread, _endthread */
#include <stddef.h>
#include <stdlib.h>
#include <conio.h>

void Bounce( void * );
void CheckKey( void * );

// GetRandom returns a random integer between min and max.
#define GetRandom( min, max ) ((rand() % (int)(((max) + 1) - (min))) + (min))
// GetGlyph returns a printable ASCII character value
#define GetGlyph( val ) ((char)((val + 32) % 93 + 33))

BOOL repeat = TRUE;                 // Global repeat flag
HANDLE hStdOut;                     // Handle for console window
CONSOLE_SCREEN_BUFFER_INFO csbi;    // Console information structure

int main()
{
    int param = 0;
    int * pparam = &param;

    // Get display screen's text row and column information.
    hStdOut = GetStdHandle( STD_OUTPUT_HANDLE );
    GetConsoleScreenBufferInfo( hStdOut, &csbi );

    // Launch CheckKey thread to check for terminating keystroke.
    _beginthread( CheckKey, 0, NULL );

    // Loop until CheckKey terminates program or 1000 threads created.
    while( repeat && param < 1000 )
    {
        // launch another character thread.
        _beginthread( Bounce, 0, (void *) pparam );

        // increment the thread parameter
        param++;

        // Wait one second between loops.
        Sleep( 1000L );
    }
}

// CheckKey - Thread to wait for a keystroke, then clear repeat flag.
void CheckKey( void * ignored )
{
    _getch();
    repeat = 0;    // _endthread implied
}

// Bounce - Thread to create and control a colored letter that moves
// around on the screen.
//
// Params: parg - the value to create the character from
void Bounce( void * parg )
{
    char       blankcell = 0x20;
    CHAR_INFO  ci;
    COORD      oldcoord, cellsize, origin;
    DWORD      result;
    SMALL_RECT region;

    cellsize.X = cellsize.Y = 1;
    origin.X = origin.Y = 0;

    // Generate location, letter and color attribute from thread argument.
    srand( _threadid );
    oldcoord.X = region.Left = region.Right =
        GetRandom(csbi.srWindow.Left, csbi.srWindow.Right - 1);
    oldcoord.Y = region.Top = region.Bottom =
        GetRandom(csbi.srWindow.Top, csbi.srWindow.Bottom - 1);
    ci.Char.AsciiChar = GetGlyph(*((int *)parg));
    ci.Attributes = GetRandom(1, 15);

    while (repeat)
    {
        // Pause between loops.
        Sleep( 100L );

        // Blank out our old position on the screen, and draw new letter.
        WriteConsoleOutputCharacterA(hStdOut, &blankcell, 1, oldcoord, &result);
        WriteConsoleOutputA(hStdOut, &ci, cellsize, origin, &region);

        // Increment the coordinate for next placement of the block.
        oldcoord.X = region.Left;
        oldcoord.Y = region.Top;
        region.Left = region.Right += GetRandom(-1, 1);
        region.Top = region.Bottom += GetRandom(-1, 1);

        // Correct placement (and beep) if about to go off the screen.
        if (region.Left < csbi.srWindow.Left)
            region.Left = region.Right = csbi.srWindow.Left + 1;
        else if (region.Right >= csbi.srWindow.Right)
            region.Left = region.Right = csbi.srWindow.Right - 2;
        else if (region.Top < csbi.srWindow.Top)
            region.Top = region.Bottom = csbi.srWindow.Top + 1;
        else if (region.Bottom >= csbi.srWindow.Bottom)
            region.Top = region.Bottom = csbi.srWindow.Bottom - 2;

        // If not at a screen border, continue, otherwise beep.
        else
            continue;
        Beep((ci.Char.AsciiChar - 'A') * 100, 175);
    }
    // _endthread given to terminate
    _endthread();
}

按任意键结束示例应用程序。

下面的代码示例演示如何使用由具有同步 API WaitForSingleObject 的 _beginthreadex 返回的线程句柄。主线程需等待第二个线程终止才能继续。当第二个线程调用 _endthreadex 时，它会导致其线程对象进入信号状态，这会允许主线程继续运行。它不能通过 _beginthread 和 _endthread 来完成，因为 _endthread 会调用 CloseHandle，这会在线程对象可以设为信号状态之前销毁它。

// crt_begthrdex.cpp
// compile with: /MT
#include <windows.h>
#include <stdio.h>
#include <process.h>

unsigned Counter;
unsigned __stdcall SecondThreadFunc( void* pArguments )
{
    printf( "In second thread...\n" );

    while ( Counter < 1000000 )
        Counter++;

    _endthreadex( 0 );
    return 0;
}

int main()
{
    HANDLE hThread;
    unsigned threadID;

    printf( "Creating second thread...\n" );

    // Create the second thread.
    hThread = (HANDLE)_beginthreadex( NULL, 0, &SecondThreadFunc, NULL, 0, &threadID );

    // Wait until second thread terminates. If you comment out the line
    // below, Counter will not be correct because the thread has not
    // terminated, and Counter most likely has not been incremented to
    // 1000000 yet.
    WaitForSingleObject( hThread, INFINITE );
    printf( "Counter should be 1000000; it is-> %d\n", Counter );
    // Destroy the thread object.
    CloseHandle( hThread );
}

Creating second thread...
In second thread...
Counter should be 1000000; it is-> 1000000

`_beginthread`，`_beginthreadex`

语法

参数

返回值

注解

要求

库

示例

另请参阅

反馈

反馈

其他资源

_beginthread，_beginthreadex

语法

参数

返回值

注解

要求

库

示例

另请参阅

反馈

反馈

其他资源

`_beginthread`，`_beginthreadex`