FsRtlGetNextExtraCreateParameter 함수(ntifs.h)

아티클
12/21/2024

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 컨텍스트 구조에 대한 선택적 포인터입니다. 있는 경우 FsRtlGetNextExtraCreateParameterCurrentEcpContext 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