Fungsi WSACreateEvent (winsock2.h)

Artikel
03/08/2023

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