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 |
|---|---|
| Panggilan WSAStartup yang berhasil harus terjadi sebelum menggunakan fungsi ini. | |
| Subsistem jaringan gagal. | |
| Panggilan Windows Sockets 1.1 yang diblokir sedang berlangsung, atau penyedia layanan masih memproses fungsi panggilan balik. | |
| 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 |