FsRtlGetNextExtraCreateParameter-Funktion (ntifs.h)

Artikel
12/21/2024

Die FsRtlGetNextExtraCreateParameter Routine gibt einen Zeiger auf die nächste (oder erste) zusätzliche Create-Parameter(ECP)-Kontextstruktur in einer bestimmten ECP-Liste zurück.

Syntax

NTSTATUS FsRtlGetNextExtraCreateParameter(
  [in]            PECP_LIST EcpList,
  [in, optional]  PVOID     CurrentEcpContext,
  [out, optional] LPGUID    NextEcpType,
  [out]           PVOID     *NextEcpContext,
  [out, optional] ULONG     *NextEcpContextSize
);

Parameter

[in] EcpList

Zeiger auf die zu untersuchende ECP-Liste.

[in, optional] CurrentEcpContext

Optionaler Zeiger auf eine ECP-Kontextstruktur in der angegebenen ECP-Liste. Wenn vorhanden, gibt FsRtlGetNextExtraCreateParameter einen Zeiger auf das ECP nach dem CurrentEcpContext ECP-Kontextstruktur zurück. Wenn CurrentEcpContext-NULL-ist, gibt FsRtlGetNextExtraCreateParameter die erste ECP-Kontextstruktur in der Liste zurück.

[out, optional] NextEcpType

Optionaler Parameter, der einen Zeiger auf die GUID der zurückgegebenen ECP-Kontextstruktur empfängt.

[out] NextEcpContext

Optionaler Parameter, der einen Zeiger auf die zurückgegebene ECP-Kontextstruktur empfängt.

[out, optional] NextEcpContextSize

Optionaler Parameter, der die Größe der zurückgegebenen ECP-Kontextstruktur in Bytes empfängt.

Rückgabewert

FsRtlGetNextExtraCreateParameter gibt einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	FsRtlGetNextExtraCreateParameter eine ECP-Kontextstruktur in der EcpList ECP-Liste gefunden.
STATUS_NOT_FOUND	Die EcpList- ECP-Liste ist leer oder CurrentEcpContext die letzte ECP in der Liste ist (d. a. es gibt kein nächstes ECP-Listenelement). Darüber hinaus wird NextEcpContext- auf NULL- und NextEcpContextSize- auf Null festgelegt.
STATUS_INVALID_PARAMETER	Der EcpList Parameter ist NULL.

Bemerkungen

DieFsRtlGetNextExtraCreateParameter Routine verarbeitet eine ECP-Liste auf nicht zirkuläre Weise. Wenn die ECP-Kontextstruktur, auf die die CurrentEcpContext Parameter verweist, das letzte Element in der ECP-Liste ist, gibt es in der Liste keine "nächste" ECP, und die Routine gibt STATUS_NOT_FOUND zurück.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Die FsRtlGetNextExtraCreateParameter-Routine ist ab Windows Vista verfügbar.
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL