ZwCreateSection-Funktion (wdm.h)

Artikel
02/29/2024

Die ZwCreateSection-Routine erstellt ein Abschnittsobjekt.

Syntax

NTSYSAPI NTSTATUS ZwCreateSection(
  [out]          PHANDLE            SectionHandle,
  [in]           ACCESS_MASK        DesiredAccess,
  [in, optional] POBJECT_ATTRIBUTES ObjectAttributes,
  [in, optional] PLARGE_INTEGER     MaximumSize,
  [in]           ULONG              SectionPageProtection,
  [in]           ULONG              AllocationAttributes,
  [in, optional] HANDLE             FileHandle
);

Parameter

[out] SectionHandle

Zeiger auf eine HANDLE-Variable, die ein Handle auf das Abschnittsobjekt empfängt.

[in] DesiredAccess

Gibt einen ACCESS_MASK Wert an, der den angeforderten Zugriff auf das Objekt bestimmt. Zusätzlich zu den Zugriffsrechten, die für alle Objekttypen definiert sind (siehe ACCESS_MASK), kann der Aufrufer alle folgenden Zugriffsrechte angeben, die für Abschnittsobjekte spezifisch sind:

DesiredAccess-Flag	Ermöglicht dem Aufrufer, dies zu tun
SECTION_EXTEND_SIZE	Erweitern Sie die Größe des Abschnitts dynamisch.
SECTION_MAP_EXECUTE	Führen Sie Ansichten des Abschnitts aus.
SECTION_MAP_READ	Leseansichten des Abschnitts.
SECTION_MAP_WRITE	Schreiben sie Ansichten des Abschnitts.
SECTION_QUERY	Fragen Sie das Abschnittsobjekt nach Informationen zum Abschnitt ab. Treiber sollten dieses Flag festlegen.
SECTION_ALL_ACCESS	Alle vorherigen Flags in Kombination mit STANDARD_RIGHTS_REQUIRED.

[in, optional] ObjectAttributes

Zeiger auf eine OBJECT_ATTRIBUTES-Struktur , die den Objektnamen und andere Attribute angibt. Verwenden Sie InitializeObjectAttributes , um diese Struktur zu initialisieren. Wenn der Aufrufer nicht in einem Systemthreadkontext ausgeführt wird, muss er das attribut OBJ_KERNEL_HANDLE festlegen, wenn initializeObjectAttributes aufgerufen wird.

[in, optional] MaximumSize

Gibt die maximale Größe des Abschnitts in Bytes an. ZwCreateSection rundet diesen Wert auf das nächste Vielfache von PAGE_SIZE. Wenn der Abschnitt von der Auslagerungsdatei unterstützt wird, gibt MaximumSize die tatsächliche Größe des Abschnitts an. Wenn der Abschnitt von einer gewöhnlichen Datei unterstützt wird, gibt MaximumSize die maximale Größe an, der die Datei erweitert oder zugeordnet werden kann.

[in] SectionPageProtection

Gibt den Schutz an, der auf jeder Seite im Abschnitt platziert werden soll. Verwenden Sie einen der folgenden vier Werte: PAGE_READONLY, PAGE_READWRITE, PAGE_EXECUTE oder PAGE_WRITECOPY. Eine Beschreibung dieser Werte finden Sie unter CreateFileMapping.

[in] AllocationAttributes

Gibt eine Bitmaske von SEC_XXX-Flags an, die die Zuordnungsattribute des Abschnitts bestimmt. Eine Beschreibung dieser Flags finden Sie unter CreateFileMapping.

[in, optional] FileHandle

Gibt optional ein Handle für ein geöffnetes Dateiobjekt an. Wenn der Wert von FileHandleNULL ist, wird der Abschnitt von der Auslagerungsdatei unterstützt. Andernfalls wird der Abschnitt von der angegebenen Datei unterstützt.

Rückgabewert

ZwCreateSection gibt STATUS_SUCCESS bei Erfolg oder den entsprechenden NTSTATUS-Fehlercode bei Einem Fehler zurück. Mögliche Fehler status Codes:

Rückgabecode	Beschreibung
STATUS_FILE_LOCK_CONFLICT	Die durch den FileHandle-Parameter angegebene Datei ist gesperrt.
STATUS_INVALID_FILE_FOR_SECTION	Die von FileHandle angegebene Datei unterstützt keine Abschnitte.
STATUS_INVALID_PAGE_PROTECTION	Der für den SectionPageProtection-Parameter angegebene Wert ist ungültig.
STATUS_MAPPED_FILE_SIZE_ZERO	Die größe der von FileHandle angegebenen Datei ist null, und MaximumSize ist 0.
STATUS_SECTION_TOO_BIG	Der Wert von MaximumSize ist zu groß. Dies tritt auf, wenn MaximumSize entweder größer als das systemdefinierte Maximum für Abschnitte ist, oder wenn MaximumSize größer als die angegebene Datei ist und der Abschnitt nicht beschreibbar ist.

Hinweise

Sobald das Handle, auf das von SectionHandle verwiesen wird, nicht mehr verwendet wird, muss der Treiber ZwClose aufrufen, um es zu schließen.

Wenn der Aufrufer nicht in einem Systemthreadkontext ausgeführt wird, muss sichergestellt werden, dass es sich bei allen von ihr erstellten Handles um private Handles handelt. Andernfalls kann der Prozess, in dessen Kontext der Treiber ausgeführt wird, auf das Handle zugreifen. Weitere Informationen finden Sie unter Objekthandles.

Weitere Informationen zum Einrichten zugeordneter Abschnitte und Sichten des Arbeitsspeichers finden Sie unter Abschnitte und Ansichten.

Wenn der Aufruf dieser Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtCreateSection" anstelle von "ZwCreateSection" 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.