(ntifs.h) ZwSetEvent 函式

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

語法

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

[in] EventHandle

事件物件的句柄。

[out, optional] PreviousState

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

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

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

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

注意如果使用者模式中發生 ZwSetEvent 函式的呼叫，您應該使用名稱「NtSetEvent」而不是「ZwSetEvent」。

針對來自內核模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本會以處理和解譯輸入參數的方式，以不同的方式運作。如需 例程 NtXxx 和 ZwXxx 版本之間關聯性的詳細資訊，請參閱使用原生系統服務例程的 Nt 和 Zw 版本。