共用方式為

IFileIsInUse：：GetCapabilities 方法 (shobjidl_core.h)

  • 發行項

判斷是否可以關閉檔案，以及 UI 是否能夠切換至使用檔案的應用程式視窗。

語法

HRESULT GetCapabilities(
  [out] DWORD *pdwCapFlags
);

參數

[out] pdwCapFlags

類型： DWORD*

值指標，當這個方法成功傳回時，會收到功能旗標。 下列其中一或兩個值：

OF_CAP_CANSWITCHTO (0x0001)

0x0001。 UI 可以切換至使用 檔案之應用程式的最上層視窗。

OF_CAP_CANCLOSE (0x0002)

0x0002。 檔案可以關閉。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

這個方法所傳回的功能可用於向使用者呈現的對話框組合，告知他們共享衝突。 例如，如果擷取OF_CAP_CANSWITCHTO旗標，可以將按鈕新增至對話方塊，以根據IFileIsInUse：：GetSwitchToHWND) 所擷取的 HWND 資訊，將使用者切換至衝突的應用程式視窗 (，讓使用者可以視需要解決這種情況。 如果擷取OF_CAP_CANCLOSE旗標，對話框可以顯示呼叫 CloseFile 方法的 [關閉] 按鈕。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)