IFileIsInUse::GetCapabilities-Methode (shobjidl_core.h)

Artikel
03/09/2024

Bestimmt, ob die Datei geschlossen werden kann und ob die Benutzeroberfläche in der Lage ist, zum Fenster der Anwendung zu wechseln, die die Datei verwendet.

Syntax

HRESULT GetCapabilities(
  [out] DWORD *pdwCapFlags
);

Parameter

[out] pdwCapFlags

Typ: DWORD*

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Methode die Funktionsflags empfängt. Ein oder beide der folgenden Werte:

OF_CAP_CANSWITCHTO (0x0001)

0x0001. Die Benutzeroberfläche kann zum Fenster der obersten Ebene der Anwendung wechseln, die die Datei verwendet.

OF_CAP_CANCLOSE (0x0002)

0x0002. Die Datei kann geschlossen werden.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die von dieser Methode zurückgegebenen Funktionen können in der Zusammensetzung des Dialogfelds verwendet werden, das dem Benutzer angezeigt wird und den Benutzer über den Freigabekonflikt informiert. Wenn instance das OF_CAP_CANSWITCHTO-Flag abgerufen wird, kann dem Dialogfeld eine Schaltfläche hinzugefügt werden, die den Benutzer zum konfliktierenden Anwendungsfenster wechselt (basierend auf den HWND-Informationen, die von IFileIsInUse::GetSwitchToHWND abgerufen werden), sodass der Benutzer die Situation nach Bedarf angehen kann. Wenn das OF_CAP_CANCLOSE-Flag abgerufen wird, kann im Dialogfeld eine Schaltfläche Schließen angezeigt werden, die die CloseFile-Methode aufruft.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Freigeben über