NTSTATUS
ZwOpenSection(
OUT PHANDLE SectionHandle,
IN ACCESS_MASK DesiredAccess,
IN POBJECT_ATTRIBUTES ObjectAttributes
);
ZwOpenSection opens a handle for an existing section object.
Parameters
SectionHandle
Points to a variable that will receive the section object handle if this call is successful.
DesiredAccess
Specifies a mask representing the requested access to the object. The set of system-defined DesiredAccess flags relevant to device and intermediate drivers are the following:
DesiredAccess Flags | Meaning |
SECTION_MAP_WRITE | A mapped view can be written. |
SECTION_MAP_READ | A mapped view can be read. |
A caller can specify SECTION_ALL_ACCESS, which sets all of the defined flags ORed with the system-defined STANDARD_RIGHTS_REQUIRED.
ObjectAttributes
Points to the initialized object attributes of the section to be opened.
Return Value
ZwOpenSection can return one of the following values:
STATUS_SUCCESS
STATUS_ACCESS_DENIED
STATUS_INVALID_HANDLE
Comments
If the specified section does not exist or the access requested is not allowed, the operation fails.
Callers of ZwOpenSection must be running at PASSIVE_LEVEL.
See Also
InitializeObjectAttributes, ZwMapViewOfSection, ZwUnmapViewOfSection