Compartilhar via

Mensagem SHAREVISTRING

  • Artigo

[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
OFN_SHAREFALLTHROUGH
2
 Aceitar o nome do arquivo
OFN_SHARENOWARN
1
 Rejeite o nome do arquivo, mas não avise o usuário. O aplicativo é responsável por exibir uma mensagem de aviso.
OFN_SHAREWARN
0
 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
Commdlg.h (inclua Windows.h)
Nomes Unicode e ANSI
 SHAREVISTRINGW (Unicode) e SHAREVISTRINGA (ANSI)

Confira também

Referência

CDN_SHAREVIOLATION

OPENFILENAME

Registerwindowmessage

Conceitual

Biblioteca de caixas de diálogo comuns