📄 waitformultipleobjects.htm
字号:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<style><!--
body,table {font-family:"宋体"; font-size: 9pt; line-height:11pt;}
a {text-decoration:none} a:hover {color:red;text-decoration:underline}
--></style>
<title>WaitForMultipleObjects</title>
</head>
<body background="../../../images/gray_weave.gif" link="#FF0000" vlink="#FF0000" alink="#FF0000" bgcolor="#FFC8C8">
<div align="center"><center>
<table border="0" width="100%" height="22" cellspacing="0" cellpadding="0">
<tr>
<td width="100%" height="16"><a name="WaitForMultipleObjects">WaitForMultipleObjects</a>,
WaitForMultipleObjectsEx</td>
</tr>
</table>
</center></div><div align="center"><center>
<table border="1" width="100%" bordercolorlight="#808080" cellspacing="0"
bordercolordark="#FFFFFF">
<tr>
<td width="100%" colspan="2">VB声明</td>
</tr>
<tr>
<td width="100%" colspan="2">Declare Function WaitForMultipleObjects& Lib
"kernel32" (ByVal nCount As Long, lpHandles As Long, ByVal bWaitAll As Long,
ByVal dwMilliseconds As Long)<br>
Declare Function WaitForMultipleObjectsEx& Lib "kernel32" (ByVal nCount As
Long, lpHandles As Long, ByVal bWaitAll As Long, ByVal dwMilliseconds As Long, ByVal
bAlertable As Long)</td>
</tr>
<tr>
<td width="100%" colspan="2">说明</td>
</tr>
<tr>
<td width="100%" colspan="2">等候单个对象或所有一系列对象发出信号，或等候指定的超时时间过去（溢出）。如返回条件已经满足，则立即返回</td>
</tr>
<tr>
<td width="100%" colspan="2">返回值</td>
</tr>
<tr>
<td width="100%" colspan="2">Long，如bWaitAll设为TRUE，则下述任何一个常数都标志着成功<br>
WAIT_ABANDONED_0：所有对象都发出消息，而且其中有一个或多个属于互斥体（一旦拥有它们的进程中止，就会发出信号）<br>
WAIT_TIMEOUT：对象保持未发信号的状态，但规定的等待超时时间已经超过<br>
WAIT_OBJECT_0：所有对象都发出信号<br>
WAIT_IO_COMPLETION：（仅适用于WaitForMultipleObjectsEx）由于一个I/O完成操作已作好准备执行，所以造成了函数的返回<br>
返回WAIT_FAILED则表示函数执行失败，会设置<a href="GetLastError.htm">GetLastError</a><br>
如bWaitAll为FALSE，那么返回结果相似，只是可能还会返回相对于WAIT_ABANDONED_0
或 WAIT_OBJECT_0的一个正偏移量，指出哪个对象是被抛弃还是发出信号。例如，WAIT_OBJECT_0
+ 5的返回结果意味着列表中的第5个对象发出了信号</td>
</tr>
<tr>
<td width="100%" colspan="2">参数表</td>
</tr>
<tr>
<td width="25%">参数</td>
<td width="75%">类型及说明</td>
</tr>
<tr>
<td width="25%">nCount</td>
<td width="75%">Long，指定列表中的句柄数量</td>
</tr>
<tr>
<td width="25%">lpHandles</td>
<td width="75%">Long，指定对象句柄组合中的第一个元素</td>
</tr>
<tr>
<td width="25%">bWaitAll</td>
<td width="75%">Long，如果为TRUE，表示除非对象都发出信号，否则就一直等待下去；如果为FALSE，表示任何对象发出信号即可</td>
</tr>
<tr>
<td width="25%">dwMilliseconds</td>
<td width="75%">Long，指定要等候的毫秒数。如设为零，表示立即返回。如指定常数INFINITE，则可根据实际情况无限等待下去</td>
</tr>
<tr>
<td width="25%">bAlertable</td>
<td width="75%">Long，仅适用于WaitForMultipleObjectsEx。倘若已用一个<a
href="ReadFileEx.htm">ReadFileEx</a> 或 <a href="WriteFileEx.htm">WriteFileEx</a>函数调用对异步I/O传输进行了初始化，而且希望函数返回——以便由那些函数指定的I/O结束例程能正常执行，那么就把这个参数设为TRUE</td>
</tr>
<tr>
<td width="100%" colspan="2">注解</td>
</tr>
<tr>
<td width="100%" colspan="2"><p align="left">在Windows NT中，对象句柄必须指定了SYNCHRONIZE（同步）访问<br>
如函数是由于对象发出信号而返回，那么这个函数可能还会得到一些额外的效果——具体由对象的类型决定。如下所示：<br>
□ 信号机：递增信号机计数<br>
□ 互斥体：将互斥体的所有权赋予发出调用的线程<br>
□ 自动重设事件：将事件发信状态设为FALSE</td>
</tr>
</table>
</center></div><div align="center"><center>
<table border="0" width="100%" cellspacing="0" cellpadding="0">
<tr>
<td width="100%"><p align="right"><a href="#WaitForMultipleObjects">Top</a></td>
</tr>
</table>
</center></div>
</body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -