SHAREVISTRING-Nachricht
[Ab Windows Vista wurden die allgemeinen Dialogfelder Öffnen und Speichern unter durch den Allgemeinen Elementdialog ersetzt. Es wird empfohlen, anstelle dieser Dialogfelder aus der Common Dialog Box Library die API für den Allgemeinen Elementdialog zu verwenden.]
Ein Dialogfeld Öffnen oder Speichern unter sendet die registrierte SHAREVISTRING-Nachricht an Ihre Hookprozedur OFNHookProc,wenn ein Freigabeverstoß 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. Das lpstrFile-Member dieser Struktur enthält den Dateinamen, der den Freigabeverstoß verursacht hat.
Rückgabewert
Die Hookprozedur muss einen der folgenden Werte zurückgeben, um anzugeben, wie das Dialogfeld den Freigabeverstoß behandeln soll.
| Rückgabecode/-wert | Beschreibung |
|---|---|
|
Akzeptieren des Dateinamens |
|
Lehnen Sie den Dateinamen ab, aber warnen Sie den Benutzer nicht. Die Anwendung ist dafür verantwortlich, eine Warnmeldung anzuzeigen. |
|
Lehnen Sie den Dateinamen ab, und zeigt eine Warnmeldung an (das gleiche Ergebnis wie bei einer Hookprozedur). |
Hinweise
Die Hookprozedur muss die SHAREVISTRING-Konstante in einem Aufruf der RegisterWindowMessage-Funktion angeben, um den Bezeichner für die vom Dialogfeld gesendete Nachricht zu erhalten.
Das Dialogfeld sendet die registrierte SHAREVISTRING-Nachricht nur, wenn Sie beim Erstellen des Dialogfelds das OFN _ SHAREAWARE-Flag nicht im Flags-Member 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) |