FsRtlGetNextExtraCreateParameter-Funktion (ntifs.h)
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 |
---|---|
|
FsRtlGetNextExtraCreateParameter hat eine ECP-Kontextstruktur in der EcpList-ECP-Liste gefunden. |
|
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. |
|
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 |
Weitere Informationen
FltAllocateExtraCreateParameter
FltAllocateExtraCreateParameterFromLookasideList
FltAllocateExtraCreateParameterList