CommDlgExtendedError

O CommDlgExtendedError função retorna um código de erro de caixa de diálogo comum. Este código indica que o erro mais recente para ocorrer durante a execução de uma das seguintes funções de caixa de diálogo comum:

ChooseColor GetOpenFileName
ChooseFont GetSaveFileName
FindText PrintDlg
ReplaceText PageSetupDlg

DWORD CommDlgExtendedError(VOID)

 

Parâmetros

Esta função não tem parâmetros.

Retornar valores

Se a chamada mais recente para a função de caixa de diálogo comum bem-sucedida, o valor de retorno é indefinido.

Se a função de caixa de diálogo comum retornado FALSE porque o usuário fechada ou cancelada caixa de diálogo, o valor de retorno é zero. Caso contrário, o valor de retorno é um código de erro diferente de zero. Para obter mais informações, consulte a seguinte seção Comentários.

Observações

O CommDlgExtendedError função pode retornar códigos de erro geral para qualquer uma das funções de caixa de diálogo comum. Além disso, há códigos de erro retornados apenas para uma caixa de diálogo comum específico. Os códigos de erro retornados pelo CommDlgExtendedError são definidos na CDERR.Arquivo H.

Os seguintes códigos de erro geral podem ser retornados para qualquer uma das funções de caixa de diálogo comuns:

Valor Significado
CDERR_DIALOGFAILURE A caixa de diálogo não pôde ser criada. Falha na chamada da função de caixa de diálogo comum para a DialogBox função. Por exemplo, este erro ocorre se a chamada de caixa de diálogo comum especifica um inválido identificador janela.
CDERR_FINDRESFAILURE A função de caixa de diálogo comum falha ao localizar um recurso especificado.
CDERR_INITIALIZATION A função de caixa de diálogo comum falha durante a inicialização. Este erro geralmente ocorre quando não houver memória suficiente.
CDERR_LOADRESFAILURE A função de caixa de diálogo comum falha ao carregar um recurso especificado.
CDERR_LOADSTRFAILURE A função de caixa de diálogo comum falha ao carregar uma Cadeia de caracteres especificada.
CDERR_LOCKRESFAILURE A função de caixa de diálogo comum falha ao bloquear um recurso especificado.
CDERR_MEMALLOCFAILURE A função de caixa de diálogo comum foi possível alocar memória para estruturas internas.
CDERR_MEMLOCKFAILURE A função de caixa de diálogo comum foi não é possível bloquear a memória associada com um identificador.
CDERR_NOHINSTANCE O sinalizador ENABLETEMPLATE foi definido na sinalizadores membro da estrutura de inicialização para o correspondente caixa de diálogo comum, mas falha para fornecer um identificador de instância correspondente.
CDERR_NOHOOK O sinalizador ENABLEHOOK foi definido na sinalizadores membro da estrutura de inicialização para o correspondente caixa de diálogo comum, mas falha para fornecer um ponteiro para um procedimento de gancho correspondente.
CDERR_NOTEMPLATE O sinalizador ENABLETEMPLATE foi definido na sinalizadores membro da estrutura de inicialização para o correspondente caixa de diálogo comum, mas falha para fornecer um correspondente modelo.
CDERR_REGISTERMSGFAIL O RegisterWindowMessage função retornou um código de erro quando ele foi chamado pela função de caixa de diálogo comum.
CDERR_STRUCTSIZE O lStructSize membro da estrutura de inicialização para o correspondente caixa de diálogo comum é inválido.

Os seguintes códigos de erro podem ser retornados para o PrintDlg função:

Valor Significado
PDERR_CREATEICFAILURE O PrintDlg função falhou quando ele tentou criar um contexto de informações.
PDERR_DEFAULTDIFFERENT Você chamou o PrintDlg função com o Sinalizar de DN_DEFAULTPRN especificado na wDefault membro da estrutura DEVNAMES , mas a impressora descrita por outros membros de estrutura não correspondeu a impressora padrão atual. (Este erro ocorre quando você armazenar a estrutura DEVNAMES e o usuário alterar a impressora padrão, usando o painel de controle).
Para usar a impressora descrita pela estrutura DEVNAMES , limpar o Sinalizar de DN_DEFAULTPRN e chamar PrintDlg novamente.

Para usar a impressora padrão, substituir a estrutura DEVNAMES (e o DEVMODE estrutura, se houver) com NULL; e chamar PrintDlg novamente.

PDERR_DNDMMISMATCH Os dados nos DEVMODE e estruturas DEVNAMES descrevem duas impressoras diferentes.
PDERR_GETDEVMODEFAIL O driver da impressora falhou ao inicializar uma estrutura de DEVMODE . (Este código de erro se aplica somente para drivers de impressora escritos para Windows versão 3.0 e posteriores).
PDERR_INITFAILURE O PrintDlg função falhou durante a inicialização, e existe um código de erro estendido não mais específico para descrever a falha. Este é o código de erro genérico padrão para a função.
PDERR_LOADDRVFAILURE O PrintDlg função falha ao carregar o driver de dispositivo para a impressora especificada.
PDERR_NODEFAULTPRN Não existe uma impressora padrão.
PDERR_NODEVICES Não há drivers de impressora foram encontrados.
PDERR_PARSEFAILURE O PrintDlg função falha ao analisar as seqüências de caracteres na secção [devices] do WIN.Arquivo INI.
PDERR_PRINTERNOTFOUND A secção [devices] da vitória.INI arquivo não contiver uma entrada para a impressora solicitada.
PDERR_RETDEFFAILURE O sinalizador PD_RETURNDEFAULT foi especificado na sinalizadores membro da estrutura PRINTDLG , mas os membros hDevMode ou hDevNames não era nulo.
PDERR_SETUPFAILURE O PrintDlg função falha ao carregar os recursos necessários.

Os seguintes códigos de erro podem ser retornados para a ChooseFont função:

Valor Significado
CFERR_MAXLESSTHANMIN O tamanho especificado na nSizeMax membro da estrutura CHOOSEFONT é menor que o tamanho especificado na nSizeMin membro.
CFERR_NOFONTS Não há fontes existentes.

Os seguintes códigos de erro podem ser retornados para o GetOpenFileName e GetSaveFileName funções:

Valor Significado
FNERR_BUFFERTOOSMALL A reserva apontado pelo lpstrFile membro das OPENFILENAME estrutura é demasiado pequena para o nome do arquivo especificado pelo usuário. Os dois primeiros bytes das lpstrFile reserva contêm um valor inteiro especificando o tamanho, em bytes (versão ANSI) ou 16-bit caracteres (versão Unicode), necessário para receber o nome completo.
FNERR_INVALIDFILENAME Um nome de arquivo é inválido.
FNERR_SUBCLASSFAILURE Uma tentativa para "subclasse" uma caixa de listagem falhou porque não havia memória suficiente disponível.

O seguinte código de erro pode ser retornado para as funções FindText e ReplaceText:

Valor Significado
FRERR_BUFFERLENGTHZERO Um membro da estrutura FINDREPLACE aponta para um buffer inválido.

Windows CE: Windows CE suporta quatro valores de retorno adicionais

CDERR_REGISTRYFAILURE
A função de caixa de diálogo comum foi possível ler do registro.

Os seguintes valores de retorno se aplica somente para o PrintDlg função:

PDERR_NOPORTS
Não há portas são registradas.
PDERR_NOPRINTERS
Não há impressoras estão registradas.
PDERR_CREATEDCFAILURE
Falha na chamada CreateDC.

Windows CE não oferece suporte os valores de retorno CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE ou CDERR_REGISTERMSGFAIL.

Windows CE não oferece suporte a qualquer um dos valores de erro PDERR_.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declaradas no commdlg.h.
Biblioteca de importação:Use comdlg32.lib.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comuns, ChooseColor, CHOOSECOLOR, ChooseFont, CHOOSEFONT, DEVMODE, DEVNAMES, DialogBox, FINDREPLACE, FindText, GetOpenFileName, GetSaveFileName, OPENFILENAME, PageSetupDlg, PAGESETUPDLG, PrintDlg, PRINTDLG, RegisterWindowMessage, ReplaceText