| 术语 | createeventex |
| 释义 | CreateEventEx 语法： C++ HANDLE WINAPI CreateEventEx( __in_opt LPSECURITY_ATTRIBUTES lpEventAttributes, __in_opt LPCTSTR lpName, __in DWORD dwFlags, __in DWORD dwDesiredAccess ); CreateEventEx功能 创建或打开一个有名或无名的事件对象，并返回一个对象的句柄。 参数 lpEventAttributes [中，可选] 一个SECURITY_ATTRIBUTES结构的指针。如果lpEventAttributes为NULL，则事件句柄不能被继承的子进程。 结构的lpSecurityDescriptor成员指定一个新的事件的安全描述符。如果lpEventAttributes为NULL，事件得到默认的安全描述。对来自事件的ACL的默认安全描述或模拟的主要创造者的象征。 lpName [中，可选] 事件的对象的名称。该名称被限制为MAX_PATH字符。名称比较是区分大小写的。 如果lpName为NULL，则事件对象创建没有名称。 如果lpName匹配相同的名称空间的另一种对象的名称(如现有的信号量，互斥体，可等待定时器，工作，或文件映射对象)，函数失败，而且GetLastError函数返回出现ERROR_INVALID_HANDLE。这是因为这些对象共享相同的名称空间。 这个名称可以有一个“全球\\”或“Local \\”前缀明确创建对象的全球或会话名称空间。名称的其余部分可以包含以外的任何字符反斜杠字符(\\)。如需信息见命名内核对象。快速用户切换是使用终端服务会话。内核对象名称必须遵循概述了终端服务，使应用程序能够支持多个用户的指导方针。 该对象可以创建一个私人空间。有关更多信息，请参见对象命名。 dwFlags [in] 此参数可以是一个或多个下列值。 ValueMeaning CREATE_EVENT_INITIAL_SET 0x00000002The事件对象的初始状态信号，否则，它是无信号。 CREATE_EVENT_MANUAL_RESET 0x00000001The event must be manually reset using the ResetEvent function.没有等待线程或线程的数目随后开始等待指定的事件对象的操作，可以释放，而该对象的状态信号。 如果此标志没有被指定，系统会自动复位后释放一个等待线程的事件。 dwDesiredAccess [in] 为事件对象访问掩码。如需使用权名单，见同步对象的安全和访问权限。 返回值 如果函数成功，返回值是一个句柄事件对象。如果命名事件对象函数调用之前存在，函数返回的句柄现有的对象和GetLastError返回ERROR_ALREADY_EXISTS。 如果函数失败，返回值为NULL。为了获得更多错误信息，调用GetLastError。 备注 任何调用进程的线程可以指定事件对象在调用句柄在等待职能之一。单对象等待函数返回时，指定对象的状态信号。在多对象等待函数可以奉命返回或者当任何一个或指定对象的所有信号。当一个等待函数返回时，等待线程被释放继续执行。 该事件对象的初始状态，是指定的dwFlags参数。使用SetEvent函数来设置一个事件对象的状态信号。使用ResetEvent函数重置事件对象状态无信号。 当一个手动重置事件对象的状态信号，但仍暗示，直到它明确地重置为无信号的ResetEvent函数。没有等待线程或线程的数目随后开始等待指定的事件对象的操作，可以释放，而该对象的状态信号。 多个进程可以有相同的事件对象的处理，使使用的进程间同步对象。下列对象共享机制可用： 子进程的CreateProcess函数创建可以继承的句柄事件对象如果CreateEvent lpEventAttributes参数启用继承。 一个进程可以指定事件对象在调用句柄DuplicateHandle函数来创建一个重复的句柄可以被另一个进程使用。 一个进程可以指定在调用一个事件对象的名称的OpenEvent或CreateEvent功能。 使用CloseHandle函数关闭处理。该系统关闭时自动处理过程终止。事件对象被销毁时，其最后处理已关闭。 要求： client最低支持Vista server最低支持 Windows Server 2008 HeaderWinbase.h(头文件：winuser.h) LibraryKernel32.lib DLLKernel32.dll Unicode和ANSI namesCreateEventExW(Unicode)和CreateEventExA(ANSI)的 参见 CloseHandle 事件对象 对象名称 同步功能 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年8月27日 ＝＝英文原文＝＝CreateEventEx Function Creates or opens a named or unnamed event object and returns a handle to the object. Syntax C++ HANDLE WINAPI CreateEventEx( __in_opt LPSECURITY_ATTRIBUTES lpEventAttributes, __in_opt LPCTSTR lpName, __in DWORD dwFlags, __in DWORD dwDesiredAccess ); Parameters lpEventAttributes [in, optional] A pointer to a SECURITY_ATTRIBUTES structure. If lpEventAttributes is NULL, the event handle cannot be inherited by child processes. The lpSecurityDescriptor member of the structure specifies a security descriptor for the new event. If lpEventAttributes is NULL, the event gets a default security descriptor. The ACLs in the default security descriptor for an event come from the primary or impersonation token of the creator. lpName [in, optional] The name of the event object. The name is limited to MAX_PATH characters. Name comparison is case sensitive. If lpName is NULL, the event object is created without a name. If lpName matches the name of another kind of object in the same name space (such as an existing semaphore, mutex, waitable timer, job, or file-mapping object), the function fails and the GetLastError function returns ERROR_INVALID_HANDLE. This occurs because these objects share the same name space. The name can have a "Global\\" or "Local\\" prefix to explicitly create the object in the global or session name space. The remainder of the name can contain any character except the backslash character (\\). For more information, see Kernel Object Namespaces . Fast user switching is implemented using Terminal Services sessions. Kernel object names must follow the guidelines outlined for Terminal Services so that applications can support multiple users. The object can be created in a private namespace. For more information, see Object Namespaces . dwFlags [in] This parameter can be one or more of the following values. ValueMeaning CREATE_EVENT_INITIAL_SET 0x00000002The initial state of the event object is signaled; otherwise, it is nonsignaled. CREATE_EVENT_MANUAL_RESET 0x00000001The event must be manually reset using the ResetEvent function. Any number of waiting threads, or threads that subsequently begin wait operations for the specified event object, can be released while the object's state is signaled. If this flag is not specified, the system automatically resets the event after releasing a single waiting thread. dwDesiredAccess [in] The access mask for the event object. For a list of access rights, see Synchronization Object Security and Access Rights . Return Value If the function succeeds, the return value is a handle to the event object. If the named event object existed before the function call, the function returns a handle to the existing object and GetLastError returns ERROR_ALREADY_EXISTS. If the function fails, the return value is NULL. To get extended error information, call GetLastError. Remarks Any thread of the calling process can specify the event-object handle in a call to one of the wait functions . The single-object wait functions return when the state of the specified object is signaled. The multiple-object wait functions can be instructed to return either when any one or when all of the specified objects are signaled. When a wait function returns, the waiting thread is released to continue its execution. The initial state of the event object is specified by the dwFlags parameter. Use the SetEvent function to set the state of an event object to signaled. Use the ResetEvent function to reset the state of an event object to nonsignaled. When the state of a manual-reset event object is signaled, it remains signaled until it is explicitly reset to nonsignaled by the ResetEvent function. Any number of waiting threads, or threads that subsequently begin wait operations for the specified event object, can be released while the object's state is signaled. Multiple processes can have handles of the same event object, enabling use of the object for interprocess synchronization. The following object-sharing mechanisms are available: A child process created by the CreateProcess function can inherit a handle to an event object if the lpEventAttributes parameter of CreateEvent enabled inheritance. A process can specify the event-object handle in a call to the DuplicateHandle function to create a duplicate handle that can be used by another process. A process can specify the name of an event object in a call to the OpenEvent or CreateEvent function. Use the CloseHandle function to close the handle. The system closes the handle automatically when the process terminates. The event object is destroyed when its last handle has been closed. Requirements Minimum supported clientWindows Vista Minimum supported serverWindows Server 2008 HeaderWinbase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll Unicode and ANSI namesCreateEventExW (Unicode) and CreateEventExA (ANSI) See Also CloseHandle Event Objects Object Names Synchronization Functions Send comments about this topic to Microsoft Build date: 8/27/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/ms682400(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。