Fungsi FsRtlGetNextExtraCreateParameter (ntifs.h)

Artikel
08/07/2023

Rutinitas FsRtlGetNextExtraCreateParameter mengembalikan penunjuk ke struktur konteks parameter pembuatan tambahan (ECP) berikutnya (atau pertama) dalam daftar ECP tertentu.

Sintaks

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

Parameter

[in] EcpList

Arahkan ke daftar ECP untuk diperiksa.

[in, optional] CurrentEcpContext

Penunjuk opsional ke struktur konteks ECP dalam daftar ECP yang diberikan. Jika ada, FsRtlGetNextExtraCreateParameter mengembalikan penunjuk ke ECP setelah struktur konteks ECP CurrentEcpContext . Jika CurrentEcpContext adalah NULL, FsRtlGetNextExtraCreateParameter mengembalikan struktur konteks ECP pertama dalam daftar.

[out, optional] NextEcpType

Parameter opsional yang menerima penunjuk ke GUID struktur konteks ECP yang dikembalikan.

[out] NextEcpContext

Parameter opsional yang menerima penunjuk ke struktur konteks ECP yang dikembalikan.

[out, optional] NextEcpContextSize

Parameter opsional yang menerima ukuran, dalam byte, dari struktur konteks ECP yang dikembalikan.

Nilai kembali

FsRtlGetNextExtraCreateParameter mengembalikan salah satu nilai NTSTATUS berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	FsRtlGetNextExtraCreateParameter menemukan struktur konteks ECP dalam daftar ECP EcpList .
STATUS_NOT_FOUND	Daftar ECP EcpList kosong atau CurrentEcpContext adalah ECP terakhir dalam daftar (yaitu, tidak ada elemen daftar ECP berikutnya). Selain itu, NextEcpContext diatur ke NULL dan NextEcpContextSize diatur ke nol.
STATUS_INVALID_PARAMETER	Parameter EcpList adalah NULL.

Keterangan

FsRtlGetNextExtraCreateParameter rutin memproses daftar ECP dengan cara yang tidak melingkar. Artinya, jika struktur konteks ECP yang diarahkan oleh parameter CurrentEcpContext adalah elemen terakhir dalam daftar ECP, tidak ada ECP "berikutnya" dalam daftar dan rutin mengembalikan STATUS_NOT_FOUND.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Rutinitas FsRtlGetNextExtraCreateParameter tersedia dimulai dengan Windows Vista.
Target Platform	Universal
Header	ntifs.h (termasuk Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL