ZwOpenSection 函式 (wdm.h)
ZwOpenSection 例程會開啟現有區段物件的句柄。
語法
NTSYSAPI NTSTATUS ZwOpenSection(
[out] PHANDLE SectionHandle,
[in] ACCESS_MASK DesiredAccess,
[in] POBJECT_ATTRIBUTES ObjectAttributes
);
參數
[out] SectionHandle
HANDLE 變數的指標，該變數會接收區段物件的句柄。
[in] DesiredAccess
指定 ACCESS_MASK 值，決定物件的要求存取權。 如需詳細資訊，請參閱 ZwCreateSection 的 DesiredAccess 參數。
[in] ObjectAttributes
指定物件名稱和其他屬性之 OBJECT_ATTRIBUTES 結構的指標。 使用 InitializeObjectAttributes 初始化這個結構。 如果呼叫端未在系統線程內容中執行，它必須在呼叫 InitializeObjectAttributes 時設定OBJ_KERNEL_HANDLE屬性。
傳回值
ZwOpenSection 會在成功時傳回STATUS_SUCCESS，或在失敗時傳回適當的錯誤碼。 可能的傳回值包括：
備註
如果區段不存在，或系統未授與要求的存取權，作業就會失敗。
一旦 SectionHandle 所指向的句柄不再使用，驅動程式必須呼叫 ZwClose 以關閉它。
如果呼叫端未在系統線程內容中執行，則必須確保所建立的任何句柄都是私用句柄。 否則，進程可以在其中執行驅動程序的內容中存取句柄。 如需詳細資訊，請參閱 物件句柄。
如果呼叫此函式發生在使用者模式中，您應該使用名稱 「NtOpenSection」 而不是 「ZwOpenSection」。。
對於核心模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需例程 NtXxx 和 ZwXxx 版本之間的關聯性詳細資訊，請參閱 使用 Nt 和 Zw 版本的原生系統服務例程。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 從 Windows 2000 開始提供。 |
| 目標平台 | Universal |
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 合規性規則 | HwStorPortProhibitedDDIs (storport) 、 PowerIrpDDis (wdm) |