次の方法で共有

FsRtlGetNextExtraCreateParameter 関数 (ntifs.h)

  • [アーティクル]

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 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

関連項目

ECP_LIST

FltAllocateExtraCreateParameter の

FltAllocateExtraCreateParameterFromLookasideList の

FltAllocateExtraCreateParameterList の

FltCreateFileEx2 を する

FltFreeExtraCreateParameter を する

FltFreeExtraCreateParameterList を する

FltGetEcpListFromCallbackData の

FltInsertExtraCreateParameter の

FltRemoveExtraCreateParameter の

FltSetEcpListIntoCallbackData の

IoCreateFileEx の