ZwSetEvent 函式（ntifs.h）

ZwSetEvent 例程會將事件物件設定為 Signaled 狀態，並嘗試滿足盡可能多的等候。

語法

NTSYSAPI NTSTATUS ZwSetEvent(
  [in]            HANDLE EventHandle,
  [out, optional] PLONG  PreviousState
);

[in] EventHandle

事件物件的句柄。

[out, optional] PreviousState

變數的選擇性指標，其中事件物件的先前狀態會儲存在輸出上。

ZwSetEvent 會傳回STATUS_SUCCESS或適當的錯誤狀態。可能的錯誤狀態代碼包括下列專案：

傳回碼	描述
STATUS_ACCESS_DENIED	呼叫端沒有修改 EventHandle 參數所指定事件的必要許可權。
STATUS_INSUFFICIENT_RESOURCES	無法設定此函式所需的資源。
STATUS_INVALID_HANDLE	提供的 EventHandle 參數無效。

ZwSetEvent 會將事件物件設定為 Signaled 狀態，並嘗試滿足盡可能多的等候。

注意如果使用者模式中呼叫 ZwSetEvent 函式，您應該使用名稱 “NtSetEvent”，而不是 “ZwSetEvent”。

對於內核模式驅動程式的呼叫，NtXxx 和 ZwXxx 版本的 Windows 原生系統服務例程，在處理和解譯輸入參數的方式上可能會有不同的行為。如需 nt NtXxx 與 ZwXxx 例程之間關聯性的詳細資訊，請參閱使用 Nt 和 Zw 版本的原生系統服務例程。