Partager via


FsRtlRemoveExtraCreateParameter, fonction (ntifs.h)

La routine FsRtlRemoveExtraCreateParameter recherche une liste ECP pour une structure de contexte ECP et, si elle est trouvée, la détache de la liste ECP.

Syntaxe

NTSTATUS FsRtlRemoveExtraCreateParameter(
  [in, out]       PECP_LIST EcpList,
  [in]            LPCGUID   EcpType,
  [out]           PVOID     *EcpContext,
  [out, optional] ULONG     *EcpContextSize
);

Paramètres

[in, out] EcpList

Pointeur vers la liste de paramètres de création supplémentaire (ECP) qui contient la structure de contexte ECP à détacher de la liste donnée.

[in] EcpType

Pointeur vers un GUID qui identifie de manière unique la structure de contexte ECP à détacher de la liste.

[out] EcpContext

Pointeur vers la structure de contexte ECP détachée. Si la structure de contexte ECP est correctement détachée de la liste donnée, ce paramètre est défini pour pointer vers la structure de contexte ECP détachée. Si la structure de contexte ECP n’est pas trouvée dans la liste ECP donnée, ce paramètre est défini sur null.

[out, optional] EcpContextSize

Paramètre facultatif qui reçoit la taille de la structure de contexte ECP détachée. Si ce paramètre est présent lorsque la routine est appelée, le paramètre reçoit la taille, en octets, de la structure de contexte ECP détachée. Si la structure de contexte ECP donnée n’a pas été trouvée dans la liste ECP donnée, ce paramètre n’est pas défini.

Valeur de retour

FsRtlRemoveExtraCreateParameter retourne un code NTSTATUS tel que l’un des éléments suivants :

Retourner le code Description
STATUS_SUCCESS La structure de contexte ECP donnée a été correctement détachée de la liste ECP donnée.
STATUS_NOT_FOUND La structure de contexte ECP donnée n’a pas été trouvée dans la liste ECP donnée.

Remarques

La routine FsRtlRemoveExtraCreateParameter recherche la liste ECP donnée par le paramètre EcpList pour une structure de contexte ECP donnée par le paramètre EcpType. Si la structure de contexte ECP existe dans la liste, FsRtlRemoveExtraCreateParameter détache la structure de la liste, définit le paramètre EcpCon text à pointer vers la structure et retourne STATUS_SUCCESS. Si la structure de contexte ECP n’existe pas dans la liste, FsRtlRemoveExtraCreateParameter définit le paramètre EcpContext sur NULL et retourne STATUS_NOT_FOUND.

Note

FsRtlRemoveExtraCreateParameter ne libère pas le pool de mémoires pour la structure de contexte ECP. Pour libérer le pool de mémoire pour la structure de contexte ECP, appelez d’abord FsRtlRemoveExtraCreateParameter pour le détacher de la liste, puis appelez la routine FltFreeExtraCreateParameter routine pour libérer le pool de mémoire pour la structure de contexte ECP.

Exigences

Exigence Valeur
client minimum pris en charge La routine FsRtlRemoveExtraCreateParameter 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

Voir aussi

ECP_LIST

FsRtlAllocateExtraCreateParameter

FsRtlAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx