Funzione FsRtlGetNextExtraCreateParameter (ntifs.h)

Articolo
12/21/2024

La routine FsRtlGetNextExtraCreateParameter restituisce un puntatore alla struttura di contesto di creazione aggiuntiva (o prima) successiva (ECP) 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 CurrentEcpContext struttura del contesto ECP. 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 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.

Osservazioni

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

Fabbisogno

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