HANDLE CreateThread(
[in, optional] LPSECURITY_ATTRIBUTES lpThreadAttributes,
[in] SIZE_T dwStackSize,
[in] LPTHREAD_START_ROUTINE lpStartAddress,
[in, optional] __drv_aliasesMem LPVOID lpParameter,
[in] DWORD dwCreationFlags,
[out, optional] LPDWORD lpThreadId
[in, optional] lpThreadAttributes
指向 SECURITY_ATTRIBUTES 结构的指针,该结构确定返回的句柄是否可以由子进程继承。 如果 lpThreadAttributes 为 NULL,则无法继承句柄。
结构的 lpSecurityDescriptor 成员为新线程指定安全描述符。 如果 lpThreadAttributes 为 NULL,则线程将获取默认的安全描述符。 线程的默认安全描述符中的 ACL 来自创建者的主要令牌。
[in] dwStackSize
堆栈的初始大小(以字节为单位)。 系统将此值舍入到最近的页面。 如果此参数为零,新线程将使用可执行文件的默认大小。 有关详细信息,请参阅 线程堆栈大小。
[in] lpStartAddress
指向由线程执行的应用程序定义函数的指针。 此指针表示线程的起始地址。 有关线程函数的详细信息,请参阅 ThreadProc。
[in, optional] lpParameter
指向要传递给线程的变量的指针。
[in] dwCreationFlags
控制线程创建的标志。
如果函数成功,则返回值是新线程的句柄。
如果函数失败,则返回值为 NULL。 要获得更多的错误信息,请调用 GetLastError。
请注意,即使 lpStartAddress 指向数据、代码或无法访问,CreateThread 也可能成功。 如果线程运行时启动地址无效,则会发生异常,线程将终止。 由于启动地址无效,线程终止作为线程进程的错误退出进行处理。 此行为类似于 CreateProcess 的异步性质,即使它引用无效或缺少动态链接库 () ,也会创建进程。
进程可以创建的线程数受可用虚拟内存的限制。 默认情况下,每个线程都有一兆字节的堆栈空间。 因此,最多可以创建 2,048 个线程。 如果减小默认堆栈大小,可以创建更多线程。 但是,如果为每个处理器创建一个线程并生成应用程序维护上下文信息的请求队列,则应用程序将具有更好的性能。 在处理下一队列中的请求之前,线程将处理队列中的所有请求。
使用 THREAD_ALL_ACCESS 访问权限创建新的线程句柄。 如果在创建线程时未提供安全描述符,则使用正在创建线程的进程的主令牌为新线程构造默认安全描述符。 当调用方尝试使用 OpenThread 函数访问线程时,会根据此安全描述符评估调用方的有效令牌,以授予或拒绝访问。
新创建的线程在调用 GetCurrentThread 函数时对自身具有完全访问权限。
Windows Server 2003: 线程对自身的访问权限是通过评估线程针对为线程构造的默认安全描述符创建的进程的主令牌来计算的。 如果在远程进程中创建了线程,则使用远程进程的主令牌。 因此,新创建的线程在调用 GetCurrentThread 时可能会降低对自身的访问权限。 某些访问权限(包括 THREAD_SET_THREAD_TOKEN 和 THREAD_GET_CONTEXT )可能不存在,从而导致意外失败。 因此,不建议在模拟其他用户时创建线程。
如果在 ((即未) 使用 CREATE_SUSPENDED 标志)创建线程,则线程可以在 CreateThread 返回之前开始运行,尤其是在调用方收到所创建的线程的句柄和标识符之前开始运行。
线程执行从 lpStartAddress 参数指定的函数开始。 如果此函数返回, 则 DWORD 返回值用于终止对 ExitThread 函数的隐式调用中的线程。 使用 GetExitCodeThread 函数获取线程的返回值。
该线程是使用 线程优先级THREAD_PRIORITY_NORMAL创建的。 使用 GetThreadPriority 和 SetThreadPriority 函数获取和设置线程的优先级值。
当线程终止时,线程对象将达到信号状态,满足正在等待该对象的任何线程。
线程对象保留在系统中,直到线程终止,并且所有句柄都通过对 CloseHandle 的调用关闭。
ExitProcess、ExitThread、CreateThread、CreateRemoteThread 函数以及由于 CreateProcess 调用 () 而启动的进程在进程内相互序列化。 一次只能在地址空间中发生其中一个事件。 这意味着以下限制保留:
在进程启动和 DLL 初始化例程期间,可以创建新线程,但在为进程完成 DLL 初始化之前,它们不会开始执行。
进程中只有一个线程可以位于 DLL 初始化或一次分离例程中。
ExitProcess 在 DLL 初始化或分离例程中没有线程之前,才完成。
调用 C 运行时库的可执行文件中的线程 (CRT) 应使用 线程管理的_beginthreadex 和 _endthreadex 函数,而不是 CreateThread 和 ExitThread;这需要使用 CRT 的多线程版本。 如果使用 CreateThread 创建的线程调用 CRT,CRT 可能会在内存不足的情况下终止进程。
Windows Phone 8.1:Windows Phone 8.1 及更高版本上Windows Phone应用商店应用支持此函数。
Windows 8.1和Windows Server 2012 R2:Windows 8.1、Windows Server 2012 R2 及更高版本的 Windows 应用商店应用支持此函数。
有关示例,请参阅 创建线程。
processthreadsapi.h (包括 Windows Server 2003、Windows Vista、Windows 7、Windows Server 2008 Windows Server 2008 R2)
Library
Kernel32.lib;Windows Phone 8.1 上的 WindowsPhoneCore.lib
Kernel32.dll;Windows Phone 8.1 上的 KernelBase.dll
CloseHandle
CreateProcess
CreateRemoteThread
ExitProcess
ExitThread
GetExitCodeThread
GetThreadPriority
进程和线程函数
ResumeThread
SECURITY_ATTRIBUTES
SetThreadPriority
SuspendThread
ThreadProc