IFileIsInUse::GetCapabilities 메서드(shobjidl_core.h)

아티클
08/26/2023

파일을 닫을 수 있는지 여부와 UI가 파일을 사용하는 애플리케이션의 창으로 전환할 수 있는지 여부를 결정합니다.

구문

HRESULT GetCapabilities(
  [out] DWORD *pdwCapFlags
);

매개 변수

[out] pdwCapFlags

형식: DWORD*

이 메서드가 성공적으로 반환될 때 기능 플래그를 수신하는 값에 대한 포인터입니다. 다음 값 중 하나 또는 둘 다:

OF_CAP_CANSWITCHTO(0x0001)

0x0001. UI는 파일을 사용하는 애플리케이션의 최상위 창으로 전환할 수 있습니다.

OF_CAP_CANCLOSE(0x0002)

0x0002. 파일을 닫을 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드에서 반환된 기능은 사용자에게 공유 충돌을 알리는 대화 상자의 컴퍼지션에 사용할 수 있습니다. instance 경우 OF_CAP_CANSWITCHTO 플래그를 검색하는 경우 대화 상자에 단추를 추가하여 사용자가 일치하는 상황을 해결할 수 있도록 충돌하는 애플리케이션 창(IFileIsInUse::GetSwitchToHWND에서 검색한 HWND 정보에 따라)으로 전환할 수 있습니다. OF_CAP_CANCLOSE 플래그를 검색하면 대화 상자에서 CloseFile 메서드를 호출하는 닫기 단추를 표시할 수 있습니다.

요구 사항

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

Share via