Fonction FsRtlGetNextExtraCreateParameter (ntifs.h)
La routine FsRtlGetNextExtraCreateParameter retourne un pointeur vers la structure de contexte ECP (extra create parameter) suivante (ou première) dans une liste ECP donnée.
Syntaxe
NTSTATUS FsRtlGetNextExtraCreateParameter(
[in] PECP_LIST EcpList,
[in, optional] PVOID CurrentEcpContext,
[out, optional] LPGUID NextEcpType,
[out] PVOID *NextEcpContext,
[out, optional] ULONG *NextEcpContextSize
);
Paramètres
[in] EcpList
Pointeur vers la liste ECP à examiner.
[in, optional] CurrentEcpContext
Pointeur facultatif vers une structure de contexte ECP dans la liste ECP donnée. Le cas échéant, FsRtlGetNextExtraCreateParameter retourne un pointeur vers l’ECP après la structure de contexte ECP CurrentEcpContext . Si CurrentEcpContext a la valeur NULL, FsRtlGetNextExtraCreateParameter retourne la première structure de contexte ECP dans la liste.
[out, optional] NextEcpType
Paramètre facultatif qui reçoit un pointeur vers le GUID de la structure de contexte ECP retournée.
[out] NextEcpContext
Paramètre facultatif qui reçoit un pointeur vers la structure de contexte ECP retournée.
[out, optional] NextEcpContextSize
Paramètre facultatif qui reçoit la taille, en octets, de la structure de contexte ECP retournée.
Valeur retournée
FsRtlGetNextExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :
Code de retour | Description |
---|---|
|
FsRtlGetNextExtraCreateParameter a trouvé une structure de contexte ECP dans la liste EcpList ECP. |
|
La liste ECP EcpList est vide ou CurrentEcpContext est le dernier ECP de la liste (autrement dit, il n’y a pas d’élément de liste ECP suivant). En outre, NextEcpContext a la valeur NULL et NextEcpContextSize est défini sur zéro. |
|
Le paramètre EcpList est NULL. |
Remarques
La routineFsRtlGetNextExtraCreateParameter traite une liste ECP de manière non circulaire. Autrement dit, si la structure de contexte ECP pointée par le paramètre CurrentEcpContext est le dernier élément de la liste ECP, il n’y a pas d’ECP « suivant » dans la liste et la routine retourne STATUS_NOT_FOUND.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | La routine FsRtlGetNextExtraCreateParameter est disponible à partir de Windows Vista. |
Plateforme cible | Universal |
En-tête | ntifs.h (include Ntifs.h) |
Bibliothèque | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
Voir aussi
FltAllocateExtraCreateParameter
FltAllocateExtraCreateParameterFromLookasideList
FltAllocateExtraCreateParameterList