MESSAGE SHAREVISTRING

  • Article

[À compter de Windows Vista, les boîtes de dialogue Ouvrir et Enregistrer sous communes ont été remplacées par la boîte de dialogue Élément commun. Nous vous recommandons d’utiliser l’API Common Item Dialog au lieu de ces boîtes de dialogue de la bibliothèque de boîtes de dialogue communes.]

Une boîte de dialogue Ouvrir ou Enregistrer sous envoie le message inscrit SHAREVISTRING à votre procédure de hook, OFNHookProc, si une violation de partage se produit pour le fichier sélectionné lorsque l’utilisateur clique sur le bouton OK .

#define SHAREVISTRING TEXT("commdlg_ShareViolation")

Paramètres

wParam

Ce paramètre n'est pas utilisé.

lParam

Pointeur vers une structure OPENFILENAME . Le membre lpstrFile de cette structure contient le nom de fichier qui a provoqué la violation de partage.

Valeur retournée

La procédure de raccordement doit retourner l’une des valeurs suivantes pour indiquer comment la boîte de dialogue doit gérer la violation de partage.

Code/valeur de retour Description
OFN_SHAREFALLTHROUGH
2
 Accepter le nom du fichier
OFN_SHARENOWARN
1
 Rejetez le nom du fichier, mais n’avertissez pas l’utilisateur. L’application est responsable de l’affichage d’un message d’avertissement.
OFN_SHAREWARN
0
 Rejetez le nom du fichier et affiche un message d’avertissement (le même résultat que s’il n’y avait pas de procédure de raccordement).

Notes

La procédure de raccordement doit spécifier la constante SHAREVISTRING dans un appel à la fonction RegisterWindowMessage pour obtenir l’identificateur du message envoyé par la boîte de dialogue.

La boîte de dialogue envoie le message inscrit SHAREVISTRING uniquement si vous n’avez pas spécifié l’indicateur OFN_SHAREAWARE dans le membre Indicateurs de la structure OPENFILENAME lors de la création du dialogue.

Si la procédure de raccordement retourne une valeur non définie, la boîte de dialogue répond comme si OFN_SHAREWARN avait été retourné.

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows 2000 Server [applications de bureau uniquement]
En-tête
Commdlg.h (inclure Windows.h)
Noms Unicode et ANSI
 SHAREVISTRINGW (Unicode) et SHAREVISTRINGA (ANSI)

Voir aussi

Référence

CDN_SHAREVIOLATION

OPENFILENAME

RegisterWindowMessage

Conceptuel

Bibliothèque de boîtes de dialogue commune