Export (0) Print
Expand All
Expand Minimize

FsRtlInsertExtraCreateParameter routine

The FsRtlInsertExtraCreateParameter routine inserts an extra create parameter (ECP) context structure into an ECP list.

Syntax


NTSTATUS FsRtlInsertExtraCreateParameter(
  _Inout_  PECP_LIST EcpList,
  _Inout_  PVOID EcpContext
);

Parameters

EcpList [in, out]

Pointer to the ECP list structure to which the ECP context structure, pointed to by the EcpContext parameter, should be added.

EcpContext [in, out]

Pointer to the ECP context structure to be added to the ECP list, pointed to by the EcpList parameter.

Return value

FsRtlInsertExtraCreateParameter returns one of the following NTSTATUS values:

Return codeDescription
STATUS_SUCCESS

The given ECP context structure was successfully inserted into the given ECP list.

STATUS_INVALID_PARAMETER

The given ECP context structure already exists in the given ECP list. In the context of ECP list insertion, two ECP context structures are considered to be identical if they contain equal GUID values.

 

Remarks

The FsRtlInsertExtraCreateParameter routine assumes that the given ECP context structure to be inserted into the given ECP list was previously allocated by the FltAllocateExtraCreateParameter routine.

Each ECP context structure inserted into the ECP list must have a unique GUID value. This unique value is set when the ECP context structure is allocated by the FltAllocateExtraCreateParameter routine.

Requirements

Version

The FltInsertExtraCreateParameter routine is available starting with Windows Vista.

Header

Ntifs.h (include Ntifs.h)

Library

Ntoskrnl.lib

IRQL

<= APC_LEVEL

See also

ECP_LIST
FltAllocateExtraCreateParameter
FltAllocateExtraCreateParameterList
FltAllocateExtraCreateParameterFromLookasideList
FltCreateFileEx2
FltFreeExtraCreateParameter
FltGetEcpListFromCallbackData
FltRemoveExtraCreateParameter
FltSetEcpListIntoCallbackData
IoCreateFileEx

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft