共用方式為


WSACreateEvent 函式 (winsock2.h)

WSACreateEvent函式會建立新的事件物件。

Syntax

WSAEVENT WSAAPI WSACreateEvent();

傳回值

如果沒有發生錯誤, WSACreateEvent 會傳回事件物件的控制碼。 否則,傳回值會WSA_INVALID_EVENT。 若要取得擴充的錯誤資訊,請呼叫 WSAGetLastError

錯誤碼 意義
WSANOTINITIALISED
使用這個函式之前,必須先進行成功的 WSAStartup 呼叫。
WSAENETDOWN
網路子系統失敗。
WSAEINPROGRESS
封鎖的 Windows Sockets 1.1 呼叫正在進行中,或服務提供者仍在處理回呼函式。
WSA_NOT_ENOUGH_MEMORY
沒有足夠的可用記憶體可建立事件物件。

備註

WSACreateEvent函式會建立初始狀態為非ignaled 的手動重設事件物件。 子進程無法繼承傳回之事件物件的控制碼。 事件物件未命名。

您可以呼叫 WSASetEvent 函式,將事件物件的狀態設定為已發出訊號。 您可以呼叫 WSAResetEvent 函式,將事件物件的狀態設定為非ignaled。 當不再需要事件物件時,應該呼叫 WSACloseEvent 函式來釋放與事件物件相關聯的資源。

Windows Sockets 2 事件物件是 Windows 環境中的系統物件。 因此,如果 Windows 應用程式想要使用自動重設事件,而不是手動重設事件,應用程式可以直接呼叫 CreateEvent 函式。 事件物件的範圍僅限於其建立所在的進程。

Windows Phone 8:Windows Phone Windows Phone 8 和更新版本上的市集應用程式支援此函式。

Windows 8.1Windows Server 2012 R2:Windows 市集應用程式在 Windows 8.1、Windows Server 2012 R2 及更新版本上支援此功能。

規格需求

   
最低支援的用戶端 Windows 8.1、Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winsock2.h
程式庫 Ws2_32.lib
Dll Ws2_32.dll

另請參閱

CreateEvent

WSACloseEvent

WSAEnumNetworkEvents

WSAEventSelect

WSAGetOverlappedResult

WSARecv

WSARecvFrom

WSAResetEvent

WSASend

WSASendTo

WSASetEvent

WSAWaitForMultipleEvents

Winsock 函式

Winsock 參考