Méthode IFileIsInUse ::GetCapabilities (shobjidl_core.h)

Article
03/04/2024

Détermine si le fichier peut être fermé et si l’interface utilisateur est capable de basculer vers la fenêtre de l’application qui utilise le fichier.

Syntaxe

HRESULT GetCapabilities(
  [out] DWORD *pdwCapFlags
);

Paramètres

[out] pdwCapFlags

Type : DWORD*

Pointeur vers une valeur qui, lorsque cette méthode retourne correctement, reçoit les indicateurs de capacité. Une ou les deux valeurs suivantes :

OF_CAP_CANSWITCHTO (0x0001)

0x0001. L’interface utilisateur peut basculer vers la fenêtre de niveau supérieur de l’application qui utilise le fichier.

OF_CAP_CANCLOSE (0x0002)

0x0002. Le fichier peut être fermé.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les fonctionnalités retournées par cette méthode peuvent être utilisées dans la composition de la boîte de dialogue présentée à l’utilisateur qui l’informe du conflit de partage. Par instance, si l’indicateur OF_CAP_CANSWITCHTO est récupéré, un bouton peut être ajouté à la boîte de dialogue qui permet à l’utilisateur de basculer vers la fenêtre d’application en conflit (en fonction des informations HWND récupérées par IFileIsInUse ::GetSwitchToHWND) afin que l’utilisateur puisse résoudre la situation comme bon lui semble. Si l’indicateur OF_CAP_CANCLOSE est récupéré, la boîte de dialogue peut présenter un bouton Fermer qui appelle la méthode CloseFile .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)

Partager via