Функция 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), содержащий структуру контекста 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 выполняет поиск списка ECP, заданного параметром EcpList для структуры контекста ECP, заданной параметром EcpType. Если структура контекста 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 |
См. также
FsRtlAllocateExtraCreateParameter