CreateEventEx

CreateEventEx,創建或打開一個事件核心對象,並返回該核心對象的句柄.

基本介紹

  • 外文名:CreateEventEx
  • 頭檔案:Winbase.h (include Windows.h)
函式信息,語法,參數,返回值,

函式信息

最低客戶端系統要求
Windows Vista
最低服務端系統要求
Windows Server 2008
頭檔案
Winbase.h (include Windows.h)
庫檔案
Kernel32.lib
動態程式庫
Kernel32.dll

語法

HANDLE WINAPI CreateEventEx(
__in_opt LPSECURITY_ATTRIBUTES lpEventAttributes,
__in_opt LPCTSTR lpName,
__in DWORD dwFlags,
__in DWORD dwDesiredAccess
);

參數

lpEventAttributes[in, optional] :
一個指向SECURITY_ATTRIBUTES結構的指針,如果該參數設為NULL,那么事件核心對象的句柄不能被子進程繼承.
lpName[in, optional] :
指向事件核心對象的名稱字元串的指針,如果該參數設為NULL,那么這個對象被創建為一個匿名事件核心對象.
dwFlags[in] :
這個參數可被設為以下一個或多個值.

意義
CREATE_EVENT_INITIAL_SET 0x00000002
對象初始狀態為已觸發,否則為未觸發.
CREATE_EVENT_MANUAL_RESET0x00000001
這個事件對象必須用ResetEvents函式手動重置,如果不設定這個標誌,系統會在核心對象被釋放後自動重置.
dwDesiredAccess[in] :
訪問許可權描述標記,詳情見Synchronization Object Security and Access Rights

返回值

如果函式調用成功,返值是所創建或打開的事件核心對象的句柄.如果調用失敗則返回NULL.

相關詞條

熱門詞條

聯絡我們