IoCheckShareAccess 함수(wdm.h)

아티클
08/08/2023

파일 개체에 대한 공유 액세스가 허용되는지 여부를 검사 위해 IoCheckShareAccess 루틴은 파일 시스템 드라이버(FSD) 또는 기타 최상위 드라이버에 의해 호출됩니다.

구문

NTSTATUS IoCheckShareAccess(
  [in]      ACCESS_MASK   DesiredAccess,
  [in]      ULONG         DesiredShareAccess,
  [in, out] PFILE_OBJECT  FileObject,
  [in, out] PSHARE_ACCESS ShareAccess,
  [in]      BOOLEAN       Update
);

매개 변수

[in] DesiredAccess

현재 열린 요청에 대해 지정된 FileObject에 대한 원하는 액세스 유형을 나타내는 ACCESS_MASK 값을 지정합니다. 드라이버는 IRP_MJ_CREATE 요청에서 요청된 액세스를 취한 다음 각 보안 설명자에 대해 SeAccessCheck 를 적용하여 부여된 실제 액세스를 확인하여 이 매개 변수의 값을 계산합니다. 부여된 액세스 권한이 원하는 액세스보다 더 제한적인 경우 이는 오류이며 드라이버는 STATUS_ACCESS_DENIED 상태 사용하여 현재 IRP를 완료해야 합니다. (SeAccessCheck는 부여된 액세스에서 MAXIMUM_ALLOWED 비트를 지웁니다. 원하는 액세스 권한을 부여된 액세스와 비교할 때 해당 비트를 사용하지 않도록 합니다.) 그런 다음 드라이버는 부여된 액세스 권한을 DesiredAccess 값으로 전달합니다.

[in] DesiredShareAccess

현재 열려 있는 요청에 대해 FileObject 에 대한 원하는 유형의 공유 액세스를 지정합니다. 이 매개 변수의 값은 일반적으로 열려 있는 요청이 수행되었을 때 I/O 관리자가 파일 시스템에 전달한 ShareAccess 또는 최상위 드라이버와 동일합니다. 이 값은 0이거나 다음의 조합일 수 있습니다.

FILE_SHARE_READ

FILE_SHARE_WRITE

FILE_SHARE_DELETE

[in, out] FileObject

현재 열려 있는 요청에 대한 액세스를 검사 파일 개체에 대한 포인터입니다.

[in, out] ShareAccess

FileObject와 연결된 일반적인 공유 액세스 데이터 구조에 대한 포인터입니다. 드라이버는 이 구조를 불투명으로 처리해야 합니다.

[in] Update

FileObject에 대한 공유 액세스 상태 업데이트할지 여부를 지정합니다. TRUE의 부울 값은 열려 있는 요청이 허용되는 경우 이 루틴이 파일 개체에 대한 공유 액세스 정보를 업데이트한다는 것을 의미합니다.

반환 값

IoCheckShareAccess 는 요청자의 파일 개체 액세스가 현재 열려 있는 방식과 호환되는 경우 STATUS_SUCCESS 반환합니다. 공유 위반으로 인해 요청이 거부되면 STATUS_SHARING_VIOLATION 반환됩니다.

설명

IoCheckShareAccess 는 파일 개체 열기 요청을 확인하여 지정된 원하는 액세스 및 공유 액세스 형식이 현재 파일 개체에 액세스하는 방식과 호환되는지 여부를 확인합니다.

파일 시스템은 FCB(파일 제어 블록)라는 구조를 통해 파일에 대한 상태를 유지 관리합니다. SHARE_ACCESS 열려 있는 모든 파일에 현재 액세스하는 방법을 설명하는 구조체입니다. 이 상태는 각 파일 개체에 대해 열린 상태의 일부로 FCB에 포함됩니다. 각 파일 개체에는 하나의 공유 액세스 구조만 있어야 합니다. 다른 최고 수준의 드라이버는 이러한 드라이버의 디바이스 개체를 나타내는 파일 개체가 열릴 때 요청된 액세스를 검사 위해 이 루틴을 호출할 수 있습니다.

IoCheckShareAccess 는 원자성 작업이 아닙니다. 따라서 이 루틴을 호출하는 드라이버는 공유 액세스 수의 손상을 방지하기 위해 뮤텍스 또는 리소스 잠금과 같은 일종의 잠금을 통해 IoCheckShareAccess 에 전달된 공유 파일 개체를 보호해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	HwStorPortProhibitedDDIs(storport), IrqlIoPassive2(wdm), PowerIrpDDis(wdm)