CDN_SHAREVIOLATION Benachrichtigungscode

[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.]

Wird von einem Explorer Dialogfeld Öffnen oder Speichern unter gesendet, wenn der Benutzer auf die Schaltfläche OK klickt und eine Netzwerkfreigabeverletzung für die ausgewählte Datei auftritt.

Ihre OFNHookProc-Hookprozedur empfängt diese Nachricht in Form einer WM_NOTIFY Nachricht.

#define CDN_FIRST               (0U-601U)
#define CDN_SHAREVIOLATION      (CDN_FIRST - 0x0003)

Parameter

wParam

Dieser Parameter wird nicht verwendet.

lParam

Ein Zeiger auf eine OFNOTIFY-Struktur . Das pszFile-Element dieser Struktur ist ein Zeiger auf den Namen der Datei, bei der die Freigabeverletzung aufgetreten ist. Die OFNOTIFY-Struktur enthält eine NMHDR-Struktur , deren Codemember die CDN_SHAREVIOLATION Benachrichtigung angibt.

Rückgabewert

Der Rückgabewert gibt an, wie das Dialogfeld den Freigabeverstoß behandeln soll.

Wenn die Hookprozedur null zurückgibt, wird im Dialogfeld die Standardwarnung für einen Freigabeverstoß angezeigt.

Um die Anzeige der Standardwarnung zu verhindern, geben Sie einen Wert ungleich null aus der Hookprozedur zurück, und rufen Sie die SetWindowLong-Funktion auf, um einen der folgenden DWL_MSGRESULT-Werte festzulegen.

Rückgabecode/-wert	BESCHREIBUNG
OFN_SHAREFALLTHROUGH 2	Bewirkt, dass das Dialogfeld den Dateinamen zurückgibt, ohne den Benutzer vor der Freigabeverletzung zu warnen.
OFN_SHARENOWARN 1	Bewirkt, dass das Dialogfeld den Dateinamen ablehnt, ohne den Benutzer vor dem Verstoß gegen die Freigabe zu warnen.

Bemerkungen

Das System sendet diese Benachrichtigung nur, wenn das Dialogfeld mit dem wert OFN_EXPLORER erstellt wurde.

Das System sendet diese Benachrichtigung nur, wenn der OFN_SHAREAWARE Wert beim Erstellen des Dialogfelds nicht angegeben 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)

Siehe auch

Referenz

GetOpenFileName

GetSaveFileName

OFNHookProc

OFNOTIFY

OPENFILENAME

SetWindowLong

Konzept

Allgemeine Dialogfeldbibliothek