Mensagem SHAREVISTRING
[A partir do Windows Vista, as caixas de diálogo abrir e salvar como comuns foram substituídas pela caixa de diálogo Item Comum. Recomendamos que você use a API de Caixa de Diálogo de Item Comum em vez dessas caixas de diálogo da Biblioteca de Caixas de Diálogo Comuns.]
Uma caixa de diálogo Abrir ou Salvar como enviará a mensagem registrada SHAREVISTRING para o procedimento de gancho, OFNHookProc, se ocorrer uma violação de compartilhamento para o arquivo selecionado quando o usuário clicar no botão OK .
#define SHAREVISTRING TEXT("commdlg_ShareViolation")
Parâmetros
-
wParam
-
Este parâmetro não é usado.
-
lParam
-
Um ponteiro para uma estrutura OPENFILENAME . O membro lpstrFile dessa estrutura contém o nome do arquivo que causou a violação de compartilhamento.
Valor retornado
O procedimento de gancho deve retornar um dos valores a seguir para indicar como a caixa de diálogo deve lidar com a violação de compartilhamento.
| Retornar código/valor | Descrição |
|---|---|
|
Aceitar o nome do arquivo |
|
Rejeite o nome do arquivo, mas não avise o usuário. O aplicativo é responsável por exibir uma mensagem de aviso. |
|
Rejeite o nome do arquivo e exibe uma mensagem de aviso (o mesmo resultado que se não houvesse nenhum procedimento de gancho). |
Comentários
O procedimento de gancho deve especificar a constante SHAREVISTRING em uma chamada para a função RegisterWindowMessage para obter o identificador da mensagem enviada pela caixa de diálogo.
A caixa de diálogo enviará a mensagem registrada SHAREVISTRING somente se você não tiver especificado o sinalizador OFN_SHAREAWARE no membro Flags da estrutura OPENFILENAME quando você criou a caixa de diálogo.
Se o procedimento de gancho retornar um valor indefinido, a caixa de diálogo responderá como se OFN_SHAREWARN fosse retornado.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Nomes Unicode e ANSI |
SHAREVISTRINGW (Unicode) e SHAREVISTRINGA (ANSI) |
Confira também
-
Referência
-
Conceitual