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
FsRtlAllocateExtraCreateParameter