Bagikan melalui


Fungsi WSACreateEvent (winsock2.h)

Fungsi WSACreateEvent membuat objek peristiwa baru.

Sintaks

WSAEVENT WSAAPI WSACreateEvent();

Mengembalikan nilai

Jika tidak ada kesalahan yang terjadi, WSACreateEvent mengembalikan handel objek peristiwa. Jika tidak, nilai yang dikembalikan WSA_INVALID_EVENT. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi WSAGetLastError.

Kode kesalahan Makna
WSANOTINITIALISED
Panggilan WSAStartup yang berhasil harus terjadi sebelum menggunakan fungsi ini.
WSAENETDOWN
Subsistem jaringan gagal.
WSAEINPROGRESS
Panggilan Windows Sockets 1.1 yang diblokir sedang berlangsung, atau penyedia layanan masih memproses fungsi panggilan balik.
WSA_NOT_ENOUGH_MEMORY
Tidak tersedia cukup memori bebas untuk membuat objek kejadian.

Keterangan

Fungsi WSACreateEvent membuat objek peristiwa reset manual dengan status awal yang tidak ditandatangani. Handel objek kejadian yang dikembalikan tidak dapat diwariskan oleh proses anak. Objek kejadian tidak disebutkan namanya.

Fungsi WSASetEvent dapat dipanggil untuk mengatur status objek peristiwa ke sinyal. Fungsi WSAResetEvent dapat dipanggil untuk mengatur status objek peristiwa ke nonsignaled. Ketika objek peristiwa tidak lagi diperlukan, fungsi WSACloseEvent harus dipanggil untuk membebaskan sumber daya yang terkait dengan objek peristiwa.

Objek peristiwa Windows Sockets 2 adalah objek sistem di lingkungan Windows. Oleh karena itu, jika aplikasi Windows ingin menggunakan peristiwa reset otomatis daripada peristiwa reset manual, aplikasi dapat memanggil fungsi CreateEvent secara langsung. Cakupan objek peristiwa terbatas pada proses pembuatannya.

Windows Phone 8: Fungsi ini didukung untuk aplikasi Windows Phone Store di Windows Phone 8 dan yang lebih baru.

Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.

Persyaratan

   
Klien minimum yang didukung Windows 8.1, Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2003 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header winsock2.h
Pustaka Ws2_32.lib
DLL Ws2_32.dll

Lihat juga

CreateEvent

WSACloseEvent

WSAEnumNetworkEvents

WSAEventPilih

WSAGetOverlappedResult

WSARecv

WSARecvFrom

WSAResetEvent

WSASend

WSASendTo

WSASetEvent

WSAWaitForMultipleEvents

Fungsi Winsock

Referensi Winsock