FsRtlGetNextExtraCreateParameter, fonction (ntifs.h)

Article
12/21/2024

La routine FsRtlGetNextExtraCreateParameter retourne un pointeur vers la structure de contexte de création supplémentaire (ou la première) suivante 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. S’il est présent, FsRtlGetNextExtraCreateParameter retourne un pointeur vers l’ECP après le CurrentEcpContext structure de contexte ECP. Si CurrentEcpContext est 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 de retour

FsRtlGetNextExtraCreateParameter retourne l’une des valeurs NTSTATUS suivantes :

Retourner le code	Description
STATUS_SUCCESS	FsRtlGetNextExtraCreateParameter trouvé une structure de contexte ECP dans la liste ecpList ECP .
STATUS_NOT_FOUND	La EcpList liste ECP est vide ou CurrentEcpContext est le dernier ECP de la liste (autrement dit, il n’existe aucun élément de liste ECP suivant). En outre, NextEcpContext est défini sur NULL et NextEcpContextSize est défini sur zéro.
STATUS_INVALID_PARAMETER	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.

Exigences

Exigence	Valeur
client minimum pris en charge	La routine FsRtlGetNextExtraCreateParameter est disponible à partir de Windows Vista.
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL