Share via

SHAREVISTRING-Nachricht

  • Artikel

[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
OFN_SHAREFALLTHROUGH
2
 Akzeptieren des Dateinamens
OFN_SHARENOWARN
1
 Lehnen Sie den Dateinamen ab, aber warnen Sie den Benutzer nicht. Die Anwendung ist für das Anzeigen einer Warnmeldung verantwortlich.
OFN_SHAREWARN
0
 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
Commdlg.h (Einschließen von Windows.h)
Unicode- und ANSI-Name
 SHAREVISTRINGW (Unicode) und SHAREVISTRINGA (ANSI)

Siehe auch

Referenz

CDN_SHAREVIOLATION

OPENFILENAME

RegisterWindowMessage

Konzept

Allgemeine Dialogfeldbibliothek