Partilhar via


CDM_GETSPEC mensagem

[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.]

Recupera o nome do arquivo (sem incluir o caminho) do arquivo selecionado no momento em uma caixa de diálogo Abrir ou Salvar como no estilo Explorer. A caixa de diálogo deve ter sido criada com o sinalizador OFN_EXPLORER ; caso contrário, a mensagem falhará.

#define WM_USER                  0x0400
#define CDM_FIRST               (WM_USER + 100)
#define CDM_GETSPEC             (CDM_FIRST + 0x0000)

Parâmetros

wParam

O tamanho, em caracteres, do buffer lParam .

lParam

Um ponteiro para o buffer que recebe o nome do arquivo.

Valor retornado

Se a mensagem for bem-sucedida, o valor retornado será o tamanho, em caracteres, da cadeia de caracteres de nome de arquivo, incluindo o caractere NULL de terminação. Esse é o número de bytes ou caracteres copiados para o buffer ou o tamanho do buffer necessário se o buffer for muito pequeno.

Se ocorrer um erro, o valor retornado será menor que zero.

Comentários

A macro correspondente é a seguinte:

int CommDlg_OpenSave_GetSpec(hwnd, lparam, wparam); 

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

OPENFILENAME

Conceitual

Biblioteca de caixas de diálogo comuns