Freigeben über


ZwUnmapViewOfSection-Funktion (wdm.h)

Die ZwUnmapViewOfSection-Routine hebt die Zuordnung einer Ansicht eines Abschnitts aus dem virtuellen Adressraum eines Betreffprozesses auf.

Syntax

NTSYSAPI NTSTATUS ZwUnmapViewOfSection(
  [in]           HANDLE ProcessHandle,
  [in, optional] PVOID  BaseAddress
);

Parameter

[in] ProcessHandle

Handle an ein Prozessobjekt, das zuvor an ZwMapViewOfSection übergeben wurde.

[in, optional] BaseAddress

Zeiger auf die virtuelle Basisadresse der Ansicht, um die Zuordnung aufzuheben. Dieser Wert kann eine beliebige virtuelle Adresse innerhalb der Ansicht sein.

Rückgabewert

ZwUnmapViewOfSection gibt einen NTSTATUS-Wert zurück. Mögliche Rückgabewerte sind:

Rückgabecode Beschreibung
STATUS_SUCCESS Die Routine hat den angeforderten Vorgang erfolgreich ausgeführt.
STATUS_ACCESS_DENIED Der Aufrufer verfügt nicht über Zugriffsrechte für das Prozessobjekt oder die virtuelle Basisadresse der Ansicht.

Hinweise

Diese Routine hebt die Zuordnung der gesamten Ansicht des Abschnitts, der BaseAddress enthält, aus dem virtuellen Adressraum des angegebenen Prozesses auf , auch wenn BaseAddress nicht auf den Anfang der Ansicht zeigt.

Bei der Rückkehr von ZwUnmapViewOfSection ist der von der Ansicht belegte virtuelle Adressbereich nicht mehr reserviert und steht zum Zuordnen anderer Ansichten oder privater Seiten zur Verfügung. Wenn die Ansicht auch der letzte Verweis auf den zugrunde liegenden Abschnitt war, werden alle committeten Seiten im Abschnitt entfernt, und der Abschnitt wird gelöscht.

Wenn der Aufruf dieser Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtUnmapViewOfSection" anstelle von "ZwUnmapViewOfSection" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienstroutinen.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwMapViewOfSection

ZwOpenSection