次の方法で共有


FsRtlRemoveExtraCreateParameter 関数 (ntifs.h)

FsRtlRemoveExtraCreateParameter ルーチンは ECP リストで ECP コンテキスト構造を検索し、見つかった場合は ECP リストからデタッチします。

構文

NTSTATUS FsRtlRemoveExtraCreateParameter(
  [in, out]       PECP_LIST EcpList,
  [in]            LPCGUID   EcpType,
  [out]           PVOID     *EcpContext,
  [out, optional] ULONG     *EcpContextSize
);

パラメーター

[in, out] EcpList

指定されたリストからデタッチされる ECP コンテキスト構造を含む追加の create パラメーター (ECP) リストへのポインター。

[in] EcpType

一覧からデタッチする ECP コンテキスト構造を一意に識別する GUID へのポインター。

[out] EcpContext

デタッチされた ECP コンテキスト構造へのポインター。 指定されたリストから ECP コンテキスト構造が正常にデタッチされた場合、このパラメーターはデタッチされた ECP コンテキスト構造を指すよう設定されます。 指定された ECP リストに ECP コンテキスト構造が見つからない場合、このパラメーターは NULL に設定されます。

[out, optional] EcpContextSize

デタッチされた ECP コンテキスト構造のサイズを受け取る省略可能なパラメーター。 ルーチンの呼び出し時にこのパラメーターが存在する場合、パラメーターはデタッチされた ECP コンテキスト構造のサイズ (バイト単位) を受け取ります。 指定された ECP コンテキスト構造が指定された ECP リストに見つからなかった場合、このパラメーターは未定義です。

戻り値

FsRtlRemoveExtraCreateParameter は、次のいずれかの NTSTATUS コードを返します。

リターン コード 説明
STATUS_SUCCESS 指定された ECP コンテキスト構造が、指定された ECP リストから正常にデタッチされました。
STATUS_NOT_FOUND 指定された ECP コンテキスト構造が、指定された ECP リストに見つかりませんでした。

注釈

FsRtlRemoveExtraCreateParameter ルーチンは、EcpList パラメーターによって指定された ECP リストを検索し、EcpType パラメーターによって指定された ECP コンテキスト構造を検索します。 ECP コンテキスト構造がリストに存在する場合、 FsRtlRemoveExtraCreateParameter は 構造体をリストからデタッチし、 EcpContext パラメーターを構造体を指すように設定し、STATUS_SUCCESSを返します。 ECP コンテキスト構造がリストに存在しない場合、 FsRtlRemoveExtraCreateParameterEcpContext パラメーターを NULL に設定し、STATUS_NOT_FOUNDを返します。

注意

FsRtlRemoveExtraCreateParameter は、ECP コンテキスト構造のメモリ プールを解放しません。 ECP コンテキスト構造のメモリ プールを解放するには、まず FsRtlRemoveExtraCreateParameter を呼び出してリストからデタッチし、 FltFreeExtraCreateParameter ルーチンを呼び出して ECP コンテキスト構造のメモリ プールを解放します。

要件

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

こちらもご覧ください

ECP_LIST

FsRtlAllocateExtraCreateParameter

FsRtlAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx