Partilhar via


CDN_SHAREVIOLATION código de notificação

[A partir do Windows Vista, as caixas de diálogo comuns Abrir e Salvar como 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.]

Enviada por uma caixa de diálogo Abrir ou Salvar como no estilo Explorer quando o usuário clica no botão OK e ocorre uma violação de compartilhamento de rede para o arquivo selecionado.

O procedimento de gancho OFNHookProc recebe essa mensagem na forma de uma mensagem de WM_NOTIFY .

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

Parâmetros

wParam

Este parâmetro não é usado.

lParam

Um ponteiro para uma estrutura OFNOTIFY . O membro pszFile dessa estrutura é um ponteiro para o nome do arquivo que teve a violação de compartilhamento. A estrutura OFNOTIFY contém uma estrutura NMHDR cujo membro de código indica a mensagem de notificação CDN_SHAREVIOLATION .

Valor retornado

O valor retornado indica como a caixa de diálogo deve lidar com a violação de compartilhamento.

Se o procedimento de gancho retornar zero, a caixa de diálogo exibirá a mensagem de aviso padrão para uma violação de compartilhamento.

Para impedir a exibição da mensagem de aviso padrão, retorne um valor diferente de zero do procedimento de gancho e chame a função SetWindowLong para definir um dos seguintes valores de DWL_MSGRESULT .

Código/valor de retorno Descrição
OFN_SHAREFALLTHROUGH
2
Faz com que a caixa de diálogo retorne o nome do arquivo sem avisar o usuário sobre a violação de compartilhamento.
OFN_SHARENOWARN
1
Faz com que a caixa de diálogo rejeite o nome do arquivo sem avisar o usuário sobre a violação de compartilhamento.

Comentários

O sistema enviará essa notificação somente se a caixa de diálogo tiver sido criada usando o valor OFN_EXPLORER .

O sistema enviará essa notificação somente se o valor OFN_SHAREAWARE não tiver sido especificado quando a caixa de diálogo foi criada.

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)

Confira também

Referência

Getopenfilename

Getsavefilename

OFNHookProc

OFNOTIFY

OPENFILENAME

Setwindowlong

Conceitual

Biblioteca de caixas de diálogo comuns