FsRtlGetNextExtraCreateParameter 関数 (ntifs.h)

[アーティクル]
08/07/2023

FsRtlGetNextExtraCreateParameter ルーチンは、指定された ECP リスト内の次の (または最初の) 追加の create パラメーター (ECP) コンテキスト構造へのポインターを返します。

構文

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

パラメーター

[in] EcpList

調べる ECP リストへのポインター。

[in, optional] CurrentEcpContext

指定された ECP リスト内の ECP コンテキスト構造へのオプションのポインター。存在する場合、 FsRtlGetNextExtraCreateParameter はCurrentEcpContext ECP コンテキスト構造の後に ECP へのポインターを返します。 CurrentEcpContext が NULL の場合、FsRtlGetNextExtraCreateParameter はリスト内の最初の ECP コンテキスト構造を返します。

[out, optional] NextEcpType

返された ECP コンテキスト構造の GUID へのポインターを受け取る省略可能なパラメーター。

[out] NextEcpContext

返された ECP コンテキスト構造へのポインターを受け取る省略可能なパラメーター。

[out, optional] NextEcpContextSize

返された ECP コンテキスト構造のサイズをバイト単位で受け取る省略可能なパラメーター。

戻り値

FsRtlGetNextExtraCreateParameter は 、次のいずれかの NTSTATUS 値を返します。

リターンコード	説明
STATUS_SUCCESS	FsRtlGetNextExtraCreateParameter で EcpList ECP リストに ECP コンテキスト構造が見つかりました。
STATUS_NOT_FOUND	EcpList ECP リストが空であるか、CurrentEcpContext がリスト内の最後の ECP です (つまり、次の ECP リスト要素はありません)。さらに、 NextEcpContext は NULL に設定され、 NextEcpContextSize は 0 に設定されます。
STATUS_INVALID_PARAMETER	EcpList パラメーターは NULL です。

注釈

FsRtlGetNextExtraCreateParameter ルーチンは、非循環方式で ECP リストを処理します。つまり、 CurrentEcpContext パラメーターが指す ECP コンテキスト構造が ECP リストの最後の要素である場合、リストに "next" ECP はなく、ルーチンはSTATUS_NOT_FOUNDを返します。

要件

要件	値
サポートされている最小のクライアント	FsRtlGetNextExtraCreateParameter ルーチンは、Windows Vista 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= APC_LEVEL