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 メソッドを呼び出す [閉じる] ボタンを表示できます。

要件