ECP_OPEN_PARAMETERS 구조체(ntifs.h)
ECP_OPEN_PARAMETERS 구조에는 호출자가 파일의 기존 핸들 및/또는 기회 잠금(oplocks)을 방해하지 않고 파일을 여는 용도를 지정할 수 있는 ECP(추가 만들기 매개 변수) 컨텍스트가 포함되어 있습니다.
통사론
typedef struct _ECP_OPEN_PARAMETERS {
USHORT Size;
USHORT Reserved;
ULONG Flags;
} ECP_OPEN_PARAMETERS, *PECP_OPEN_PARAMETERS;
회원
Size
이 컨텍스트 구조의 크기를 바이트 단위로 지정합니다.
Reserved
나중에 사용할 수 있습니다. 이 값은 0으로 초기화해야 합니다.
Flags
파일을 열기 위한 매개 변수 또는 용도를 지정하는 플래그입니다. 플래그 다음 값의 조합일 수 있습니다.
| 값 | 묘사 |
|---|---|
| ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ(0x0001) | 파일을 열어 읽습니다. |
| ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE(0x0002) | 쓸 파일을 엽니다. |
| ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_DELETE(0x0004) | 파일을 열어 삭제합니다. |
| ECP_OPEN_PARAMETERS_FLAG_IGNORE_DIR_CASE_SENSITIVITY(0x0008) | 대/소문자를 구분하는 디렉터리에서도 이 파일에 대해 대/소문자를 구분하지 않는 조회를 강제로 엽니다. Windows 10 버전 2004부터 사용할 수 있습니다. |
| ECP_OPEN_PARAMETERS_FLAG_FAIL_ON_CASE_SENSITIVE_DIR(0x0010) | 경로에 대/소문자를 구분하는 디렉터리에 있는 경우 파일을 열거나 요청을 만들지 못합니다. Windows 10 버전 2004부터 사용할 수 있습니다. |
발언
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ 및 ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE 플래그는 읽기/쓰기 액세스를 위해 해당 파일을 실제로 열지 않고도 암호화된 파일에 대한 읽기/쓰기 액세스를 허용합니다. 이러한 ECP 플래그를 사용하면 메타데이터 전용 액세스를 위해 커널 모드 구성 요소를 열 수 있으므로 읽기/쓰기를 위해 암호화 컨텍스트 설정을 가져오는 동안 다른 액세스를 방해하지 않습니다. 필터는 잠금과의 충돌을 방지하기 위해 이러한 플래그를 설정할 수 있습니다. 읽기/쓰기 작업에 대한 암호화 상태 설정은 비용이 많이 들며 읽기/쓰기 액세스를 위해 파일을 열지 않는 경우 일반적으로 수행되지 않습니다.
시스템 정의 GUID_ECP_OPEN_PARAMETERS 값은 FltAllocateExtraCreateParameter 및 FsRtlRemoveExtraCreateParameter같은 ECP 관련 지원 루틴을 호출할 때 이 ECP 컨텍스트 구조와 함께 사용됩니다.
자세한 내용은 추가 만들기 매개 변수 소개를 참조하세요.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 버전 1709. |
| 헤더 | ntifs.h(Ntifs.h 포함) |