Funzione FsRtlRemoveExtraCreateParameter (ntifs.h)

La routine FsRtlRemoveExtraCreateParameter cerca in un elenco ECP una struttura di contesto ECP e, se presente, la scollega dall'elenco ECP.

Sintassi

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

Parametri

[in, out] EcpList

Puntatore all'elenco di parametri di creazione aggiuntivi (ECP) che contiene la struttura di contesto ECP da scollegare dall'elenco specificato.

[in] EcpType

Puntatore a un GUID che identifica in modo univoco la struttura del contesto ECP da scollegare dall'elenco.

[out] EcpContext

Puntatore alla struttura di contesto ECP scollegata. Se la struttura del contesto ECP viene scollegata correttamente dall'elenco specificato, questo parametro verrà impostato in modo che punti alla struttura di contesto ECP scollegata. Se la struttura del contesto ECP non viene trovata nell'elenco ECP specificato, questo parametro è impostato su NULL.

[out, optional] EcpContextSize

Parametro facoltativo che riceve le dimensioni della struttura di contesto ECP scollegata. Se questo parametro è presente quando viene chiamata la routine, il parametro riceverà le dimensioni, in byte, della struttura di contesto ECP scollegata. Se la struttura del contesto ECP specificata non è stata trovata nell'elenco ECP specificato, questo parametro non è definito.

Valore restituito

FsRtlRemoveExtraCreateParameter restituisce un codice NTSTATUS, ad esempio uno dei seguenti:

Codice restituito Descrizione
STATUS_SUCCESS La struttura del contesto ECP specificata è stata scollegata correttamente dall'elenco ECP specificato.
STATUS_NOT_FOUND La struttura del contesto ECP specificata non è stata trovata nell'elenco ECP specificato.

Commenti

La routine FsRtlRemoveExtraCreateParameter cerca nell'elenco ECP specificato dal parametro EcpList una struttura di contesto ECP specificata dal parametro EcpType . Se la struttura del contesto ECP esiste nell'elenco, FsRtlRemoveExtraCreateParameter scollega la struttura dall'elenco, imposta il parametro EcpContext in modo che punti alla struttura e restituisca STATUS_SUCCESS. Se la struttura del contesto ECP non esiste nell'elenco, FsRtlRemoveExtraCreateParameter imposta il parametro EcpContext su NULL e restituisce STATUS_NOT_FOUND.

Nota

FsRtlRemoveExtraCreateParameter non libera il pool di memoria per la struttura del contesto ECP. Per liberare il pool di memoria per la struttura del contesto ECP, chiamare prima FsRtlRemoveExtraCreateParameter per scollegarlo dall'elenco e quindi chiamare la routine FltFreeExtraCreateParameter per liberare il pool di memoria per la struttura del contesto ECP.

Requisiti

Requisito Valore
Client minimo supportato La routine FsRtlRemoveExtraCreateParameter è disponibile a partire da Windows Vista.
Piattaforma di destinazione Universale
Intestazione ntifs.h (include Ntifs.h)
Libreria NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Vedi anche

ECP_LIST

FsRtlAllocateExtraCreateParameter

FsRtlAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx