IFileIsInUse 인터페이스(shobjidl_core.h)

아티클
03/02/2024

다른 애플리케이션에서 사용 중인 파일에 대한 정보를 얻거나 닫기 위해 호출할 수 있는 메서드를 노출합니다. 애플리케이션이 파일에 액세스하려고 시도하고 이미 사용 중인 파일을 찾으면 이 인터페이스의 메서드를 사용하여 대화 상자에서 사용자에게 표시할 정보를 수집할 수 있습니다.

상속

IFileIsInUse 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IFileIsInUse 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IFileIsInUse 인터페이스에는 이러한 메서드가 있습니다.


IFileIsInUse::CloseFile 현재 사용 중인 파일을 닫습니다.
IFileIsInUse::GetAppName 파일을 사용하는 애플리케이션의 이름을 검색합니다.
IFileIsInUse::GetCapabilities 파일을 닫을 수 있는지 여부와 UI가 파일을 사용하는 애플리케이션의 창으로 전환할 수 있는지 여부를 결정합니다.
IFileIsInUse::GetSwitchToHWND 파일을 사용하는 애플리케이션의 최상위 창 핸들을 검색합니다.
IFileIsInUse::GetUsage 사용 중인 파일이 사용되는 방식을 나타내는 값을 가져옵니다.

설명

Windows Vista 이전 버전의 Windows에서 사용자가 다른 애플리케이션에서 열려 있는 파일에 액세스하려고 하면 파일이 이미 열려 있다는 메시지가 포함된 대화 상자가 표시됩니다. 메시지는 사용자가 다른 애플리케이션을 닫는 것을 지시했지만 식별하지 못했습니다. 이 제안 이외에 대화 상자는 상황을 해결하기 위한 사용자 작업을 제공하지 않았습니다. 이 인터페이스는 사용자가 직접 작업을 수행할 수 있는 보다 유익한 대화 상자로 이어질 수 있는 메서드를 제공합니다.

실행 중인 개체 테이블

애플리케이션에서 파일을 열면 인스턴스화된 IFileIsInUse 개체를 ROT(실행 중인 개체 테이블)에 삽입하여 파일을 등록합니다. ROT는 현재 실행 중인 개체를 추적하는 전역적으로 액세스할 수 있는 조회 테이블입니다. 이러한 개체는 모니커로 식별할 수 있습니다. 클라이언트가 모니커를 개체에 바인딩하려고 하면 모니커가 ROT를 확인하여 개체가 이미 실행 중인지 확인합니다. 이렇게 하면 모니커가 새 instance 로드하는 대신 현재 instance 바인딩할 수 있습니다.

ROT에 파일을 추가하려면 다음 단계를 수행합니다.

GetRunningObjectTable 함수를 호출하여 IRunningObjectTable의 instance 검색합니다.
현재 사용 중인 파일에 대한 IFileIsInUse 개체를 만듭니다.
현재 사용 중인 파일에 대한 IMoniker 개체를 만듭니다.
IRunningObjectTable::Register를 호출하여 IFileIsInUse 및 IMoniker 개체를 ROT에 삽입합니다.

등록 호출에서 ROTFLAGS_ALLOWANYCLIENT 플래그를 지정합니다. 이렇게 하면 ROT 항목이 보안 경계를 넘어 작동할 수 있습니다. 이 플래그를 사용하려면 호출하는 애플리케이션에 명시적 애플리케이션 사용자 모델 ID(AppUserModelID)(System.AppUserModel.ID)가 있어야 합니다. 명시적 AppUserModelID를 사용하면 COM(구성 요소 개체 모델)이 애플리케이션의 보안 설정을 검사할 수 있습니다. ROTFLAGS_ALLOWANYCLIENT 사용하여 Register 를 호출하려고 하면 명시적 AppUserModelID가 실패합니다. ROTFLAGS_ALLOWANYCLIENT 플래그 없이 Register 를 호출할 수 있으며 애플리케이션은 자체 보안 수준 내에서만 올바르게 작동합니다.

구현 시기

다른 애플리케이션에서 열 수 있는 파일 형식을 여는 애플리케이션은 IFileIsInUse를 구현해야 합니다. 이 인터페이스의 애플리케이션 구현을 사용하면 Windows Explorer 공유 오류의 원인을 검색할 수 있으므로 사용자가 이러한 오류로 인해 실패한 작업을 처리하고 다시 시도할 수 있습니다.

사용해야 하는 경우

애플리케이션은 IFileIsInUse를 호출하여 다른 애플리케이션과 통신하여 공유 오류를 resolve. 이러한 오류는 파일 시스템의 사용자 작업에 대한 응답으로 발생합니다. 예를 들어 애플리케이션에서 해당 폴더의 파일이 열려 있는 동안 사용자가 폴더 이름을 바꾸려고 하면 이름 바꾸기 작업이 실패합니다. Windows Explorer 해당 애플리케이션의 IFileIsInUse 구현을 호출하여 사용자가 충돌을 식별하고 이 문제를 resolve 수 있습니다.

샘플

IFileIsInUse를 구현하고 ROT에 파일을 등록하는 방법을 보여 주는 파일 사용 중 샘플을 참조하세요. 그런 다음 , 사용 중인 파일 대화 상자를 사용자 지정하여 애플리케이션에서 현재 열려 있는 파일에 대한 추가 정보 및 옵션을 표시하는 방법을 보여 냅니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)

추가 정보

애플리케이션 사용자 모델 ID(AppUserModelID)

다음을 통해 공유