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

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