다음을 통해 공유

ZwDeleteFile 함수(ntifs.h)

  • 아티클

ZwDeleteFile 루틴은 지정된 파일을 삭제합니다.

통사론

NTSYSAPI NTSTATUS ZwDeleteFile(
  [in] POBJECT_ATTRIBUTES ObjectAttributes
);

매개 변수

[in] ObjectAttributes

호출자가 파일 개체에 사용할 특성을 포함하는 OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 예를 들어 이러한 특성에는 ObjectName 및 SECURITY_DESCRIPTOR포함됩니다. 이 매개 변수는 InitializeObjectAttributes 매크로를 호출하여 초기화됩니다.

반환 값

ZwDeleteFile 작업의 최종 완료 상태를 나타내는 STATUS_SUCCESS 또는 적절한 오류 상태를 반환합니다. 가능한 오류 상태 코드에는 다음이 포함됩니다.

반환 코드 묘사
STATUS_INSUFFICIENT_RESOURCES 이 함수에 필요한 임시 버퍼를 할당할 수 없습니다.
STATUS_INVALID_PARAMETER 지정한 ObjectAttributes 매개 변수는 OBJECT_ATTRIBUTES 구조체에 대한 유효한 포인터가 아닌 NULL 포인터이거나 지정된 ObjectAttributes 구조체 멤버 중 일부가 잘못되었습니다.
STATUS_OBJECT_NAME_INVALID ObjectAttributes 매개 변수에는 OBJECT_NAME_PATH_SEPARATOR 문자 뒤의 빈 문자열이 발견되었기 때문에 유효하지 않은 OBJECT_ATTRIBUTES 구조체에 ObjectName 포함되어 있습니다.
STATUS_OBJECT_NAME_NOT_FOUND ObjectAttributes 매개 변수에는 찾을 수 없는 OBJECT_ATTRIBUTES 구조체의 ObjectName 멤버가 포함되어 있습니다.
STATUS_OBJECT_PATH_NOT_FOUND ObjectAttributes 매개 변수에는 찾을 수 없는 개체 경로가 있는 OBJECT_ATTRIBUTES 구조체의 ObjectName 멤버가 포함되어 있습니다.
STATUS_OBJECT_PATH_SYNTAX_BAD ObjectAttributes 매개 변수는 RootDirectory 멤버를 포함하지 않았지만 OBJECT_ATTRIBUTES 구조체의 ObjectName 멤버가 빈 문자열이거나 OBJECT_NAME_PATH_SEPARATOR 문자를 포함하지 않았습니다. 개체 경로에 대한 잘못된 구문을 나타냅니다.

발언

ZwDeleteFile 지정된 파일 개체를 삭제합니다.

ZwDeleteFile 함수는 InitializeAttributes 매크로를 사용하여 파일 개체를 삭제할 OBJECT_ATTRIBUTES 구조의 특성을 설정한 후에 호출됩니다.

ZwDeleteFile사용하여 삭제할 파일의 이름을 지정하는 두 가지 다른 방법이 있습니다.

  • 입력 ObjectAttributes의 ObjectName 멤버에 제공된 정규화된 경로 이름으로
  • 입력 ObjectAttributes의 RootDirectory 멤버에서 핸들이 나타내는 디렉터리 파일을 기준으로 하는 경로 이름으로

ZwDeleteFile 호출자는사용하도록 설정된 특수 커널 APC를 사용하여 IRQL = PASSIVE_LEVEL 및 실행되어야 합니다.

ZwDeleteFile 함수에 대한 호출이 사용자 모드에서 발생하는 경우 "ZwDeleteFile" 대신 "NtDeleteFile" 이름을 사용해야 합니다.

커널 모드 드라이버의 호출의 경우 NtXxx 및 ZwXxx 버전의 Windows Native System Services 루틴은 입력 매개 변수를 처리하고 해석하는 방식으로 다르게 동작할 수 있습니다. NtXxx ZwXxx 루틴 버전 간의 관계에 대한 자세한 내용은 네이티브 시스템 서비스 루틴Nt 및 Zw 버전 사용 참조하세요.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows XP
대상 플랫폼 보편적
헤더 ntifs.h(Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL(설명 섹션 참조)
DDI 규정 준수 규칙 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

참고 항목

InitializeObjectAttributes

OBJECT_ATTRIBUTES