FsRtlRemoveExtraCreateParameter 函式（ntifs.h）

發行項
12/21/2024

FsRtlRemoveExtraCreateParameter 例程會搜尋 ECP 內容結構清單，如果找到，則會將其與 ECP 清單中斷連結。

語法

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

參數

[in, out] EcpList

額外建立參數（ECP）清單的指標，其中包含要與指定清單中斷連結的 ECP 內容結構。

[in] EcpType

GUID 的指標，可唯一識別要從清單中卸離的 ECP 內容結構。

[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 內容結構，FsRtlRemoveExtraCreateParameter將 ecpContext 參數設定為 NULL，並傳回STATUS_NOT_FOUND。

注意

FsRtlRemoveExtraCreateParameter 不會釋放 ECP 內容結構的記憶體集區。若要釋放 ECP 內容結構的記憶體集區，請先呼叫 FsRtlRemoveExtraCreateParameter 將它與清單中斷連結，然後呼叫 FltFreeExtraCreateParameter 例程來釋放 ECP 內容結構的記憶體集區。

要求

要求	價值
最低支援的用戶端	FsRtlRemoveExtraCreateParameter 例程可從 Windows Vista 開始使用。
目標平臺	普遍
標頭	ntifs.h （include Ntifs.h）
連結庫	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL