Função CommDlgExtendedError (commdlg.h)
Retorna um código de erro de caixa de diálogo comum. Esse código indica o erro mais recente a ocorrer durante a execução de uma das funções comuns da caixa de diálogo.
Sintaxe
DWORD CommDlgExtendedError();
Retornar valor
Tipo: DWORD
Se a chamada mais recente para uma função de caixa de diálogo comum tiver sido bem-sucedida, o valor retornado será indefinido. Se a função de caixa de diálogo comum retornar FALSE porque o usuário fechou ou cancelou a caixa de diálogo, o valor retornado será zero. Caso contrário, o valor retornado será um código de erro diferente de zero.
A função CommDlgExtendedError pode retornar códigos de erro gerais para qualquer uma das funções comuns da caixa de diálogo. Além disso, há códigos de erro que são retornados apenas para uma caixa de diálogo comum específica. Todos esses códigos de erro são definidos em Cderr.h. Os códigos de erro gerais a seguir podem ser retornados para qualquer uma das funções comuns da caixa de diálogo.
| Valor/código retornado | Descrição |
|---|---|
|
Não foi possível criar a caixa de diálogo. Falha na chamada da função de caixa de diálogo comum para a função DialogBox . Por exemplo, esse erro ocorrerá se a chamada da caixa de diálogo comum especificar um identificador de janela inválido. |
|
A função de caixa de diálogo comum não conseguiu localizar um recurso especificado. |
|
A função de caixa de diálogo comum falhou durante a inicialização. Esse erro geralmente ocorre quando a memória suficiente não está disponível. |
|
A função de caixa de diálogo comum falhou ao carregar um recurso especificado. |
|
A função de caixa de diálogo comum falhou ao carregar uma cadeia de caracteres especificada. |
|
A função de caixa de diálogo comum falhou ao bloquear um recurso especificado. |
|
A função de caixa de diálogo comum não pôde alocar memória para estruturas internas. |
|
A função de caixa de diálogo comum não pôde bloquear a memória associada a um identificador. |
|
O sinalizador ENABLETEMPLATE foi definido no membro Flags da estrutura de inicialização da caixa de diálogo comum correspondente, mas você não forneceu um identificador de instância correspondente. |
|
O sinalizador ENABLEHOOK foi definido no membro Flags da estrutura de inicialização da caixa de diálogo comum correspondente, mas você não forneceu um ponteiro para um procedimento de gancho correspondente. |
|
O sinalizador ENABLETEMPLATE foi definido no membro Flags da estrutura de inicialização da caixa de diálogo comum correspondente, mas você não forneceu um modelo correspondente. |
|
A função RegisterWindowMessage retornou um código de erro quando foi chamada pela função de caixa de diálogo comum. |
|
O membro lStructSize da estrutura de inicialização da caixa de diálogo comum correspondente é inválido. |
Os códigos de erro a seguir podem ser retornados para a função PrintDlg .
| Valor/código retornado | Descrição |
|---|---|
|
A função PrintDlg falhou quando tentou criar um contexto de informações. |
|
Você chamou a função PrintDlg com o sinalizador DN_DEFAULTPRN especificado no membro wDefault da estrutura DEVNAMES , mas a impressora descrita pelos outros membros da estrutura não correspondeu à impressora padrão atual. Esse erro ocorre quando você armazena a estrutura DEVNAMES e o usuário altera a impressora padrão usando o Painel de Controle.
Para usar a impressora descrita pela estrutura DEVNAMES , desmarque o sinalizador DN_DEFAULTPRN e chame PrintDlg novamente. Para usar a impressora padrão, substitua a estrutura DEVNAMES (e a estrutura, se existir) por NULL; e chame PrintDlg novamente. |
|
Os dados nas estruturas DEVMODE e DEVNAMES descrevem duas impressoras diferentes. |
|
O driver da impressora não conseguiu inicializar uma estrutura DEVMODE . |
|
A função PrintDlg falhou durante a inicialização e não há um código de erro estendido mais específico para descrever a falha. Esse é o código de erro padrão genérico para a função . |
|
A função PrintDlg falhou ao carregar o driver do dispositivo para a impressora especificada. |
|
Uma impressora padrão não existe. |
|
Nenhum driver de impressora foi encontrado. |
|
A função PrintDlg não pôde analisar as cadeias de caracteres na seção [dispositivos] do arquivo WIN.INI. |
|
A seção [dispositivos] do arquivo WIN.INI não continha uma entrada para a impressora solicitada. |
|
O sinalizador PD_RETURNDEFAULT foi especificado no membro Flags da estrutura PRINTDLG , mas o membro hDevMode ou hDevNames não era NULL. |
|
A função PrintDlg falhou ao carregar os recursos necessários. |
Os códigos de erro a seguir podem ser retornados para a função ChooseFont .
| Valor/código retornado | Descrição |
|---|---|
|
O tamanho especificado no membro nSizeMax da estrutura CHOOSEFONT é menor que o tamanho especificado no membro nSizeMin . |
|
Não existem fontes. |
Os códigos de erro a seguir podem ser retornados para as funções GetOpenFileName e GetSaveFileName .
| Valor/código retornado | Descrição |
|---|---|
|
O buffer apontado pelo membro lpstrFile da estrutura OPENFILENAME é muito pequeno para o nome de arquivo especificado pelo usuário. Os dois primeiros bytes do buffer lpstrFile contêm um valor inteiro especificando o tamanho necessário para receber o nome completo, em caracteres. |
|
Um nome de arquivo é inválido. |
|
Falha na tentativa de subclasse de uma caixa de listagem porque não havia memória suficiente disponível. |
O código de erro a seguir pode ser retornado para as funções FindText e ReplaceText .
| Valor/código retornado | Descrição |
|---|---|
|
Um membro da estrutura FINDREPLACE aponta para um buffer inválido. |
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] |
| Plataforma de Destino | Windows |
| Cabeçalho | commdlg.h (inclua Windows.h) |
| Biblioteca | Comdlg32.lib |
| DLL | Comdlg32.dll |
| Conjunto de APIs | ext-ms-win-shell-comdlg32-l1-1-0 (introduzido no Windows 10, versão 10.0.10240) |
Confira também
Biblioteca de caixas de diálogo comuns
Conceitual
Referência