ZwOpenSection

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