Estrutura OFNOTIFYA (commdlg.h)

Artigo
11/20/2024

Contém informações sobre uma mensagem de WM_NOTIFY enviada a um procedimento de gancho de OFNHookProc para uma caixa de diálogo Abrir ou Salvar como. O parâmetro lParam da mensagem WM_NOTIFY é um ponteiro para uma estrutura OFNOTIFY.

Sintaxe

typedef struct _OFNOTIFYA {
  NMHDR           hdr;
  LPOPENFILENAMEA lpOFN;
  LPSTR           pszFile;
} OFNOTIFYA, *LPOFNOTIFYA;

Membros

hdr

Tipo: NMHDR

O código membro dessa estrutura pode ser uma das seguintes mensagens de notificação que identificam a mensagem que está sendo enviada: CDN_FILEOK, CDN_FOLDERCHANGE, CDN_HELP, CDN_INITDONE, CDN_SELCHANGE, CDN_SHAREVIOLATION, CDN_TYPECHANGE.

lpOFN

Tipo: LPOPENFILENAME

Um ponteiro para a estrutura de OPENFILENAME que foi especificada quando a caixa de diálogo Abrir ou Salvar como foi criada. Para algumas das mensagens de notificação, essa estrutura contém informações adicionais sobre o evento que causou a notificação.

pszFile

Tipo: LPTSTR

O nome do arquivo para o qual ocorreu uma violação de compartilhamento de rede. Esse membro é válido apenas com a mensagem de notificação CDN_SHAREVIOLATION.

Observações

Nem todas as mensagens de notificação Abrir e Salvar como usam a estrutura de OFNOTIFY. A mensagem de notificação CDN_INCLUDEITEM usa a estrutura de OFNOTIFYEX.

Nota

O cabeçalho commdlg.h define OFNOTIFY como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho	commdlg.h (inclua Windows.h)