关于若干Win32多线程函数API详解
CreateThread
函数功能：该函数创建一个在调用进程的地址空间中执行的线程。
函数原型：
HANDLE CreateThread ( LPSECURITY_ATTRIBUTES lpThreadAttributes,
DWORD dwStackSize, LPTHREAD_START_ROUTINE lpStartAddress,
LPVOID lpParameter，DWORD dwCreationFlags, LPDWORD lpThreadld);
参数：
lpThreadAttributes：指向——个SECURITY_ATTRIBUTES结构，该结构决定了返回的句柄是否可被子进程继承。若lpThreadAttributes为NULL，则句柄不能被继承。
在Windows NT中该结构的lpSecurityDescriptor成员定义了新进程的安全性描述符。若lpThreadAttributes为NULL，则线程获得一个缺省的安全性描述符。
dwStackSize：定义原始堆栈提交时的大小(按字节计)。系统将该值舍入为最近的页。若该值为0，或小于缺省时提交的大小，缺省情况是使用与调用线程同样的大小。更多的信息，请看线程堆栈大小。
lpStarAddress：指向一个LPTHREAD_START_ROUTINE类型的应用定义的函数，该线程执行此函数。该指针还表示远程进程中线程的起始地址。该函数必须存在于远程进程中。
lpParameter：定义一个传递给该进程的32位值。
dwCreationFlags：定义控制进程创建的附加标志。若定义了CREATE_SUSPENDED标志，线程创建时处于挂起状态，并且直到ResumeThread函数调用时才能运行。若该值为0，则该线程在创建后立即执行。
lpThreadld：指向一个32位值，它接受该线程的标识符。
返回值：
若函数调用成功，返回值为新线程的句柄；若函数调用失败,返回值为NULL。
备注：
新进程的句柄创建时设为THREAD_ALL_ACESS访问权限。若未提供安全性描述符，则该句柄可被任何要求一个线程对象句柄的函数所使用。若提供了安全性描述符，则以后使用该句柄时，将在授权访问以前执行访问检查。若访问检查拒绝访问，则请求进程不能使用该句柄获得对该线程的访问。
线程从lpStartAddress参数定义的函数处开始执行。若该函数返回，则DWORD返回值被用于以隐含调用ExitThread函数的方法终止该线程。使用GetExitCodeThread函数来获得线程的返回值。
CreateRemoteThread函数使得一个新的执行线程从指定进程的地址空间开始执行。该线程可以访问进程打开的所有对象。
新线程的句柄创建时对于新线程具有完全访问的权限。若未提供安全性描述符，则任何一个需要线
程对象句柄的函数均可使用该句柄。若提供了一个安全性描述符，则以后使用该句柄时，将在授权访问
以前执行访问检查。若访问检查拒绝访问，则请求进程不能使用该句柄获得对该线程的访问。
即使lpStartAddress指向数据，代码，或不可访问，CreateRemoteThread函数仍能成功调用。若线程运行时起始地址无效，则发生异常，线程终止。由于无效的起始地址而终止的线程被处理为“从该线程的进程中错误退出”。此种行为类似于CreateProcess的异步特性。在CreateProcess函数中，即使进程引用了无效的或己丢失的动态连接库(DLL)仍能被创建。
线程创建时拥有THREAD_PRIORITY_NORMAL优先权。使用GetThreadPriority和SetThreadPriority函数可以获得和设置线程的优先权值。
—个线程终止时，该线程对象被设为发信号状态，以满足在该对象上等待的所有进程。
一个线程对象始终存在于系统中，直到该线程终止，且它所有的句柄都已通过调用CloseHandle函数关闭。
ExitProcess,ExitThread,CreateThread,CreateRemoteThread和一个正被启动(调用CreateProcess的结果)的进程将被在进程内部彼此串联起来。任一时刻，在某一地址空间中仅能发生上述事件之一。这意味着将有如下的限制：
l 在进程启动和DLL初始化例程期间，可以创建新线程，但是新线程只有在进程的DLL初始化完成后才开始执行。
l 任一时刻，进程中仅有一个线程可以存在于一个DLL初始化例程或一个分离例程中。
l 仅当所有线程的DLL初始化例程和分离例程都已完成时，ExitProcess函数才返回。
使用C运行时间库函数的线程应当使用C运行时间函数来进行线程管理，而不是使用CreateThread和ExitThread函数。若不这样做，调用ExitThread函数时将导致少量内存泄漏。
ExitThread
函数功能：该函数结束一个线程。
函数原型：
VOID ExitThread( DWORD dwExitCode );
参数：
dwExitCode：定义调用线程的退出代码。使用GetExitCodeThread函数来检取一个线程的退出代码。
返回值：无。
备注：
调用ExitThread函数，是结束一个线程的较好的方法。调用该函数后(或者直接地调用，或者从一个线程过程返回)，当前线程的堆栈去配线程终止。所有附加动态连接库(DLL)的入口点函数被激活，激活值表明该线程正从DLL脱离。若调用该函数时，该线程为进程的最后一个线程，则该线程的进程也被终止。
线程对象的状态变为发信号状态，以释放所有正在等待该线程终止的其他线程。线程的终止状态从STILL_ACTIVATE变为dwExitCode参数的值。
线程结束时不必从操作系统中移去该线程对象。当线程的最后一个句柄关闭时，该线程对象被删除。
ExitProcess，ExitThread，CreateThread，CreateRemoteThread和一个正被启动(调用CreateProcess的结果)的进程将被在进程内部被此串联起来。任一时刻，在某一地址空间中仅能发生上述事件之一。这意味着将有如下的限制：
l 在进程启动和DLL初始化例程期间，可以创建新线程，但是新线程只有在进程的DLL初始化完成后才开始行。
l 任一时刻，进程中仅有一个线程可以存在于一个DLL初始化例程或一个分离例程中。
l 仅当所有线程的DLL初始化例程和分离例程都己完成时，ExitProcess函数才返回。
使用C运行时间库函数的线程应当使用C运行时间函数来进行线程管理，而不是使用CreateThread和ExitThread函数。若不这样做，调用ExitThread函数时将导致少量内存泄漏。
Sleep
函数功能：该函数对于指定的时间间隔挂起当前的执行线程。
函数原型：VOID Sleep(DWORD dwMilliseconds)；
参数：
dwMilliseconds：定义挂起执行线程的时间，以毫秒为单位。取值为0时，该线程将余下的时间片交给处于就绪状态的同一优先级的其他线程。若没有处于就绪状态的同一优先级的其他线程，则函数立即返回，该线程继续执行。若取值为INFINITE则造成无限延迟。
返回值：该函数没有返回值。
备注：一个线程可以在调用该函数时将睡眠时间设为0毫秒，以将剩余的时间片交出。
使用Sleep函数和直接或间接创建窗口的代码时必须非常小心。若线程创建了窗口，它就必须处理消息。消息广播被发送给系统中的所有窗口。若有一个线程调用Sleep函数时使用了无限延迟，则系统会死锁。两个直接创建窗口的代码的例子是DDE和COM CoInitialize。因此，若有一个创建窗口的线程，则使用MsgWaitForMutipleObjects和MsgWaitForMutipleObjectsEx函数，而不使用Sleep函数。
CreateMutex
函数功能：该函数是创建有名或者无名的互斥对象。
函数原型：
HANDLE CreateMutex( LPSECURITY_ATTRIBUTES lpMutexAttributes，
BOOL bInitialOwner, LPCTSTR lpName )；
参数：
lpMutexAttributes：指向SECURITY_ATTRIBUTES结构的指针，该结构决定子进程是否能继承返回句柄。如果lpMutexAttributes为NULL，那么句柄不能被继承。
在Windows NT中该结构的lpSecurityDescriptor成员指定新互斥对象的安全描述符。如果lpMutexAttributes为NULL，那么互斥对象获得缺省的安全描述符。
bInitialOwner：指定互斥对象的初始所属身份。如果该值为TRUE并且调用者创建互斥对象，那么调用线程获得互斥对象所属身份。否则，调用线程不能获得互斥对象所属身份。判断调用者是否创建互斥对象请参阅返回值部分。
lpName：指向以NULL结尾的字符串，该字符串指定了互斥对象名。该名字的长度小于MAX_PATH且可以包含除反斜线路径分隔符（ / ）以外的任何字符。名字是区分大小写的。
如果lpName与已存在的有名互斥对象名相匹配，那么该函数要求用MUTEX_ALL_ACCESS权限访问已存在的对象。在这种情况下，由于参数bInitialOwner己被创建进程所设置，该参数被忽略。如果参数lpMutexAttributes不为NULL，它决定句柄是否解除继承，但是其安全描述符成员被忽略。
如果lpName为NULL，那么创建的互斥对象无名。
如果lpName与已存在的事件、信号量、可等待定时器、作业、或者文件映射对象的名字相匹配，那么函数调用失败，并且GetLastError函数返回ERPOR_INVALID_HANDLE。其原因是这些对象共享相同的名字空间。
返回值：
如果函数调用成功，返回值是互斥对象句柄；如果函数调用之前，有名互斥对象已存在，那么函数给已存在的对象返回一个句柄，并且函数GetLastError返回ERROR_ALREADY_EXISTS，否则，调用者创建互斥对象。
如果函数调用失败，则返回值为NULL。若想获得更多错误信息，请调用GetLastError函数。
备注：
由函数CreateMutex返回的句柄有MUTEX_ALL_ACCESS权限可以去访问新的互斥对象，并且可用在要求互斥对象句柄的任何函数中。
调用进程中的任何线程可以在调用等待函数时指定互斥对象句柄。当指定对象的状态为信号态时，返回单对象等待函数。当任何一个或者所有的互斥对象为信号态时，返回多对象等待函数被指令。等待函数返回后，等待的线程被释放继续向下执行。
当一个互斥对象不被任何线程拥有时，处于信号态。创建该对象的线程可以使用bInitialOwner标志来请求立即获得对该互斥对象的拥有权。否则，线程必须使用等待函数来请求拥有权。当互斥对象处于信号态，等待的线程获得对该对象的拥有权时，此互斥对象的状态被设置为非信号态，等待函数返回。任意时刻，仅有一个线程能拥有该互斥对象，线程可以使用ReleaseMutex函数来释放对这个互斥对象的拥有权。
若线程已经拥有了一个互斥对象，那么它可以重复调用等待函数而不会发生阻塞，一般情况下，用户不会重复等待同一个互斥对象，但是这种机制防止了线程因等待它已经拥有的互斥对象而发生死锁。然而，线程必须为每一次等待调用一次ReleaseMutex函数来释放该互斥对象。
两个或多个进程可以调用CreateMutex来创建同名的互斥对象，第一个进程实际创建互斥对象，以后的进程打开已存在的互斥对象的句柄。这使得多个进程可以得到同一个互斥对象的句柄，从而减轻了用户的负担，使用户不必判断创建进程是否为第一个启动的进程。使用这种技术时，应该把bInitialOwner标志设为FALSE；否则很难确定开始时哪一个进程拥有该互斥对象。
由于多进程能够拥有相同互斥对象的句柄，通过使用这个对象，可使多进程同步。以下为共亨对象机制：
如果CreateMutex中的lpMutexAttributes参数允许继承，由CreateProcess函数创建的子进程可以继承父进程的互斥对象句柄。
一个进程可以在调用DuplicateHandle函数时指定互斥对象句柄来创建一个可以被其他进程使用的双重句柄。一个进程在调用OpenMutex或CreateMutex函数时能指定互斥对象名。
使用CloseHandle函数关闭句柄，进程结束时系统自动关闭句柄。当最后一个句柄被关闭时，互斥对象被销毁。
ReleaseMutex
函数功能：该函数放弃指定互斥对象的拥有权。
函数原型：BOOL ReleaseMutex(HANDLE hMutex)；
参数：
hMutex：互斥对象句柄。为CreateMutex或OpenMutex函数的返回值。
返回值：
如果函数调用成功，那么返回值是非零值；如果函数调用失败，那么返回值是零值。若想获得更多错误信息，请调用GetLastError函数。
备注：
如果调用线程不拥有互斥对象，ReleaseMutex函数失败。
一个线程通过调用等待函数拥有互斥对象。创建该互斥对象的线程也拥有互斥对象，而不需要调用等待函数。当互斥对象的所有者线程不再需要互斥对象时，它可以调用ReleaseMutex函数。
当一个线程拥有一个互斥对象后，它可以用该互斥对象多次调用等待函数而不会阻塞。这防止一个线程等待一个它已拥有的互斥对象时出现死锁。不过，为了释放所有权，该线程必须为每一个等待操作调用一次ReleaseMutex函数。
WaitForSingleObject
函数功能：当如下情况之一发生时该函数返回：指定对象处于信号态；超时。
函数原型：
DWORD WaitForSingleObject( HANDLE hHandle，DWORD dwMilliseconds)；
参数：
hHandle：等待对象句柄。若想了解指定句柄的对象类型列表，参阅下面说明