Метод IFileIsInUse::GetCapabilities (shobjidl_core.h)

Статья
03/05/2024

Определяет, можно ли закрыть файл и способен ли пользовательский интерфейс переключаться в окно приложения, использующее файл.

Синтаксис

HRESULT GetCapabilities(
  [out] DWORD *pdwCapFlags
);

Параметры

[out] pdwCapFlags

Тип: DWORD*

Указатель на значение, которое при успешном возвращении этого метода получает флаги возможностей. Одно или оба из следующих значений:

OF_CAP_CANSWITCHTO (0x0001)

0x0001. Пользовательский интерфейс может переключиться в окно верхнего уровня приложения, использующее файл.

OF_CAP_CANCLOSE (0x0002)

0x0002. Файл можно закрыть.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Возможности, возвращаемые этим методом, можно использовать в составе диалогового окна, которое сообщает пользователю о конфликте общего доступа. Например, при извлечении флага OF_CAP_CANSWITCHTO в диалоговое окно можно добавить кнопку, которая переключит пользователя в конфликтующее окно приложения (на основе сведений HWND , полученных IFileIsInUse::GetSwitchToHWND), чтобы пользователь смог решить ситуацию по своему желанию. Если флаг OF_CAP_CANCLOSE получен, в диалоговом окне может быть представлена кнопка Закрыть , которая вызывает метод CloseFile .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)

Поделиться через