Funzione FsRtlRemoveExtraCreateParameter (ntifs.h)

Articolo
02/29/2024

La routine FsRtlRemoveExtraCreateParameter cerca in un elenco ECP una struttura di contesto ECP e, se trovata, 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 del 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 di contesto ECP non viene trovata nell'elenco ECP specificato, questo parametro viene 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 di 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.

Osservazioni

La routine FsRtlRemoveExtraCreateParameter cerca l'elenco ECP fornito dal parametro EcpList per 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 di 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 scollegarlo dall'elenco e quindi chiamare la routine fltFreeExtraCreateParameter per liberare il pool di memoria per la struttura del contesto ECP.

Fabbisogno

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