SHAREVISTRING-Nachricht
[Ab Windows Vista wurden die allgemeinen Dialogfelder Öffnen und Speichern unter durch das Dialogfeld "Gemeinsame Elemente" ersetzt. Es wird empfohlen, anstelle dieser Dialogfelder aus der Common Dialog Box Library die API für allgemeine Elemente zu verwenden.]
Ein Dialogfeld Öffnen oder Speichern unter sendet die registrierte SHAREVISTRING-Nachricht an Ihre Hookprozedur OFNHookProc, wenn eine Freigabeverletzung für die ausgewählte Datei auftritt, wenn der Benutzer auf die Schaltfläche OK klickt.
#define SHAREVISTRING TEXT("commdlg_ShareViolation")
Parameter
-
wParam
-
Dieser Parameter wird nicht verwendet.
-
lParam
-
Ein Zeiger auf eine OPENFILENAME-Struktur . Der lpstrFile-Member dieser Struktur enthält den Dateinamen, der den Verstoß gegen die Freigabe verursacht hat.
Rückgabewert
Die Hookprozedur muss einen der folgenden Werte zurückgeben, um anzugeben, wie das Dialogfeld die Freigabeverletzung behandeln soll.
Rückgabecode/-wert | BESCHREIBUNG |
---|---|
|
Akzeptieren des Dateinamens |
|
Lehnen Sie den Dateinamen ab, aber warnen Sie den Benutzer nicht. Die Anwendung ist für das Anzeigen einer Warnmeldung verantwortlich. |
|
Lehnen Sie den Dateinamen ab, und es wird eine Warnmeldung angezeigt (dasselbe Ergebnis, als ob keine Hookprozedur vorhanden wäre). |
Bemerkungen
Die Hookprozedur muss die SHAREVISTRING-Konstante in einem Aufruf der RegisterWindowMessage-Funktion angeben, um den Bezeichner für die vom Dialogfeld gesendete Nachricht abzurufen.
Das Dialogfeld sendet die registrierte SHAREVISTRING-Nachricht nur, wenn Sie beim Erstellen des Dialogfelds nicht das flag OFN_SHAREAWARE im Flags-Element der OPENFILENAME-Struktur angegeben haben.
Wenn die Hookprozedur einen nicht definierten Wert zurückgibt, antwortet das Dialogfeld so, als ob OFN_SHAREWARN zurückgegeben wurde.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
Header |
|
Unicode- und ANSI-Name |
SHAREVISTRINGW (Unicode) und SHAREVISTRINGA (ANSI) |