Metode IFileIsInUse::GetCapabilities (shobjidl_core.h)

Artikel
03/04/2024

Menentukan apakah file dapat ditutup dan apakah UI mampu beralih ke jendela aplikasi yang menggunakan file .

Sintaks

HRESULT GetCapabilities(
  [out] DWORD *pdwCapFlags
);

Parameter

[out] pdwCapFlags

Jenis: DWORD*

Penunjuk ke nilai yang, ketika metode ini berhasil dikembalikan, menerima bendera kemampuan. Salah satu atau kedua nilai berikut:

OF_CAP_CANSWITCHTO (0x0001)

0x0001. UI dapat beralih ke jendela tingkat atas aplikasi yang menggunakan file .

OF_CAP_CANCLOSE (0x0002)

0x0002. File dapat ditutup.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Kemampuan yang dikembalikan oleh metode ini dapat digunakan dalam komposisi kotak dialog yang disajikan kepada pengguna yang memberi tahu mereka tentang konflik berbagi. Misalnya, jika bendera OF_CAP_CANSWITCHTO diambil, tombol dapat ditambahkan ke kotak dialog yang akan mengalihkan pengguna ke jendela aplikasi yang berkonflik (berdasarkan informasi HWND yang diambil oleh IFileIsInUse::GetSwitchToHWND) sehingga pengguna dapat mengatasi situasi sesuai keinginan mereka. Jika bendera OF_CAP_CANCLOSE diambil, kotak dialog dapat menyajikan tombol Tutup yang memanggil metode CloseFile .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Bagikan melalui