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
OFN _ SHAREFALLTHROUGH
2
Akzeptieren des Dateinamens
OFN _ SHARENOWARN
1
Lehnen Sie den Dateinamen ab, aber warnen Sie den Benutzer nicht. Die Anwendung ist dafür verantwortlich, eine Warnmeldung anzuzeigen.
OFN _ SHAREWARN
0
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
Commdlg.h (include Windows.h)
Unicode- und ANSI-Name
SHAREVISTRINGW (Unicode) und SHAREVISTRINGA (ANSI)

Siehe auch

Verweis

_CDN SHAREVIOLATION

OPENFILENAME

RegisterWindowMessage

Konzept

Allgemeine Dialogfeldbibliothek