Funzione FsRtlGetNextExtraCreateParameter (ntifs.h)

Articolo
08/07/2023

La routine FsRtlGetNextExtraCreateParameter restituisce un puntatore alla struttura di contesto di creazione aggiuntiva successiva (o prima) in un determinato elenco ECP.

Sintassi

NTSTATUS FsRtlGetNextExtraCreateParameter(
  [in]            PECP_LIST EcpList,
  [in, optional]  PVOID     CurrentEcpContext,
  [out, optional] LPGUID    NextEcpType,
  [out]           PVOID     *NextEcpContext,
  [out, optional] ULONG     *NextEcpContextSize
);

Parametri

[in] EcpList

Puntatore all'elenco ECP da esaminare.

[in, optional] CurrentEcpContext

Puntatore facoltativo a una struttura di contesto ECP nell'elenco ECP specificato. Se presente, FsRtlGetNextExtraCreateParameter restituisce un puntatore all'ECP dopo la struttura di contesto ECP CurrentEcpContext . Se CurrentEcpContext è NULL, FsRtlGetNextExtraCreateParameter restituisce la prima struttura del contesto ECP nell'elenco.

[out, optional] NextEcpType

Parametro facoltativo che riceve un puntatore al GUID della struttura di contesto ECP restituita.

[out] NextEcpContext

Parametro facoltativo che riceve un puntatore alla struttura di contesto ECP restituita.

[out, optional] NextEcpContextSize

Parametro facoltativo che riceve le dimensioni, in byte, della struttura di contesto ECP restituita.

Valore restituito

FsRtlGetNextExtraCreateParameter restituisce uno dei valori NTSTATUS seguenti:

Codice restituito	Descrizione
STATUS_SUCCESS	FsRtlGetNextExtraCreateParameter ha trovato una struttura di contesto ECP nell'elenco EcpList ECP .
STATUS_NOT_FOUND	L'elenco EcpList ECP è vuoto o CurrentEcpContext è l'ultimo ECP nell'elenco, ovvero non esiste alcun elemento di elenco ECP successivo. Inoltre, NextEcpContext è impostato su NULL e NextEcpContextSize è impostato su zero.
STATUS_INVALID_PARAMETER	Il parametro EcpList è NULL.

Commenti

La routineFsRtlGetNextExtraCreateParameter elabora un elenco ECP in modo non circolare. Ovvero, se la struttura del contesto ECP puntata dal parametro CurrentEcpContext è l'ultimo elemento nell'elenco ECP, non esiste un ECP "next" nell'elenco e la routine restituisce STATUS_NOT_FOUND.

Requisiti

Requisito	Valore
Client minimo supportato	La routine FsRtlGetNextExtraCreateParameter è 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