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)