Share via

Messaggio SHAREVISTRING

  • Articolo

[A partire da Windows Vista, le finestre di dialogo Comuni Apri e Salva con nome sono state sostituite dalla finestra di dialogo Elemento comune. È consigliabile usare l'API Finestra di dialogo elemento comune anziché queste finestre di dialogo dalla libreria delle finestre di dialogo comuni.

Una finestra di dialogo Apri o Salva con nome invia il messaggio registrato SHAREVISTRING alla procedura hook , OFNHookProc, se si verifica una violazione di condivisione per il file selezionato quando l'utente fa clic sul pulsante OK .

#define SHAREVISTRING TEXT("commdlg_ShareViolation")

Parametri

wParam

Questo parametro non viene usato.

lParam

Puntatore a una struttura OPENFILENAME . Il membro lpstrFile di questa struttura contiene il nome file che ha causato la violazione di condivisione.

Valore restituito

La procedura hook deve restituire uno dei valori seguenti per indicare come la finestra di dialogo deve gestire la violazione di condivisione.

Codice/valore restituito Descrizione
OFN_SHAREFALLTHROUGH
2
 Accettare il nome del file
OFN_SHARENOWARN
1
 Rifiutare il nome del file ma non avvisare l'utente. L'applicazione è responsabile della visualizzazione di un messaggio di avviso.
OFN_SHAREWARN
0
 Rifiutare il nome del file e visualizzare un messaggio di avviso (lo stesso risultato di se non vi fosse alcuna procedura hook).

Commenti

La routine hook deve specificare la costante SHAREVISTRING in una chiamata alla funzione RegisterWindowMessage per ottenere l'identificatore per il messaggio inviato dalla finestra di dialogo.

La finestra di dialogo invia il messaggio registrato SHAREVISTRING solo se non è stato specificato il flag OFN_SHAREAWARE nel membro Flags della struttura OPENFILENAME al momento della creazione della finestra di dialogo.

Se la routine hook restituisce un valore non definito, la finestra di dialogo risponde come se OFN_SHAREWARN fosse restituito.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional [solo app desktop]
Server minimo supportato
 Windows 2000 Server [solo app desktop]
Intestazione
Commdlg.h (include Windows.h)
Nomi Unicode e ANSI
 SHAREVISTRINGW (Unicode) e SHAREVISTRINGA (ANSI)

Vedi anche

Riferimento

CDN_SHAREVIOLATION

OPENFILENAME

RegisterWindowMessage

Informazioni concettuali

Libreria delle finestre di dialogo comuni