FsRtlGetNextExtraCreateParameter-Funktion (ntifs.h)

Artikel
08/07/2023

Die FsRtlGetNextExtraCreateParameter-Routine gibt einen Zeiger auf die nächste (oder erste) ECP-Kontextstruktur (extra create parameter) 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. Falls vorhanden, gibt FsRtlGetNextExtraCreateParameter nach der ECP-Kontextstruktur CurrentEcpContext einen Zeiger auf den ECP zurück. Wenn CurrentEcpContextNULL 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 hat eine ECP-Kontextstruktur in der EcpList-ECP-Liste gefunden.
STATUS_NOT_FOUND	Die EcpList-ECP-Liste ist leer, oder CurrentEcpContext ist das letzte ECP in der Liste (d.a. es gibt kein nächstes ECP-Listenelement). Darüber hinaus ist NextEcpContext auf NULL und NextEcpContextSize auf Null festgelegt.
STATUS_INVALID_PARAMETER	Der EcpList-Parameter ist NULL.

Hinweise

DieFsRtlGetNextExtraCreateParameter-Routine verarbeitet eine ECP-Liste auf nicht zirkuläre Weise. Das heißt, wenn die ECP-Kontextstruktur, auf die der CurrentEcpContext-Parameter verweist, das letzte Element in der ECP-Liste ist, gibt es kein "nächstes" ECP in der Liste, und die Routine gibt STATUS_NOT_FOUND zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Die FsRtlGetNextExtraCreateParameter-Routine ist ab Windows Vista verfügbar.
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL