次の方法で共有

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント FsRtlRemoveExtraCreateParameter ルーチンは、Windows Vista 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

関連項目

ECP_LIST

FsRtlAllocateExtraCreateParameter

FsRtlAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2 の

FltFreeExtraCreateParameter の

FltGetEcpListFromCallbackData の

FltInsertExtraCreateParameter を する

FltRemoveExtraCreateParameter を する

FltSetEcpListIntoCallbackData の

IoCreateFileEx の