FsRtlGetNextExtraCreateParameter 함수(ntifs.h)

아티클
08/07/2023

FsRtlGetNextExtraCreateParameter 루틴은 지정된 ECP 목록의 다음(또는 첫 번째) ECP(추가 만들기 매개 변수) 컨텍스트 구조에 대한 포인터를 반환합니다.

구문

NTSTATUS FsRtlGetNextExtraCreateParameter(
  [in]            PECP_LIST EcpList,
  [in, optional]  PVOID     CurrentEcpContext,
  [out, optional] LPGUID    NextEcpType,
  [out]           PVOID     *NextEcpContext,
  [out, optional] ULONG     *NextEcpContextSize
);

매개 변수

[in] EcpList

검사할 ECP 목록에 대한 포인터입니다.

[in, optional] CurrentEcpContext

지정된 ECP 목록의 ECP 컨텍스트 구조에 대한 선택적 포인터입니다. 있는 경우 FsRtlGetNextExtraCreateParameter 는 CurrentEcpContext ECP 컨텍스트 구조 다음에 ECP에 대한 포인터를 반환합니다. CurrentEcpContext가 NULL이면 FsRtlGetNextExtraCreateParameter는 목록의 첫 번째 ECP 컨텍스트 구조를 반환합니다.

[out, optional] NextEcpType

반환된 ECP 컨텍스트 구조의 GUID에 대한 포인터를 수신하는 선택적 매개 변수입니다.

[out] NextEcpContext

반환된 ECP 컨텍스트 구조에 대한 포인터를 수신하는 선택적 매개 변수입니다.

[out, optional] NextEcpContextSize

반환된 ECP 컨텍스트 구조의 크기(바이트)를 수신하는 선택적 매개 변수입니다.

반환 값

FsRtlGetNextExtraCreateParameter 는 다음 NTSTATUS 값 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	FsRtlGetNextExtraCreateParameter 는 EcpList ECP 목록에서 ECP 컨텍스트 구조를 찾았습니다.
STATUS_NOT_FOUND	EcpList ECP 목록이 비어 있거나 CurrentEcpContext가 목록의 마지막 ECP입니다(즉, 다음 ECP 목록 요소가 없음). 또한 NextEcpContext 는 NULL 로 설정되고 NextEcpContextSize 는 0으로 설정됩니다.
STATUS_INVALID_PARAMETER	EcpList 매개 변수는 NULL입니다.

설명

FsRtlGetNextExtraCreateParameter 루틴은 ECP 목록을 순환되지 않은 방식으로 처리합니다. 즉, CurrentEcpContext 매개 변수가 가리키는 ECP 컨텍스트 구조가 ECP 목록의 마지막 요소인 경우 목록에 "다음" ECP가 없고 루틴이 STATUS_NOT_FOUND 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	FsRtlGetNextExtraCreateParameter 루틴은 Windows Vista부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ntifs.h(Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL