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


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

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

Синтаксис

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)