Compartilhar via


CommDlgExtendedError

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa função retorna um valor de erro caixa de diálogo comum. Esse valor indica o erro mais recente para ocorrer durante a execução de uma das funções de caixa de diálogo comum.

Syntax

DWORD CommDlgExtendedError() 

Return Value

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

Se a função 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 diferente de zero código de erro. Para obter mais informações, consulte a seguinte seção Comentários.

Remarks

Para todas as plataformas

CommDlgExtendedError Retorna o erro mais recente para ocorrer durante a execução de um das seguinte funções caixa de diálogo comum:

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 que são retornados somente para um caixa de diálogo comum específico. Os códigos de erro retornados pelo CommDlgExtendedError são definidos no arquivo de CDERR.H.

O seguinte códigos de erro gerais podem ser retornados por qualquer uma das funções de caixa de diálogo comum:

  • CDERR_DIALOGFAILURE
    Caixa de diálogo não pôde ser criada. Chamar a função caixa de diálogo comum para a DialogBox função falha. De exemplo, esse erro ocorre se o chamar caixa de diálogo comum especifica um inválido identificador janela.
  • CDERR_FINDRESFAILURE
    A falha função caixa de diálogo comum para localizar um recurso especificado.
  • CDERR_INITIALIZATION
    A função caixa de diálogo comum falha durante inicialização. Este erro geralmente ocorre quando não é memória suficiente disponível.
  • CDERR_LOADRESFAILURE
    A função caixa de diálogo comum falha ao carregar um recurso especificado.
  • CDERR_LOCKRESFAILURE
    A falha função caixa de diálogo comum para bloqueio um recurso especificado.
  • CDERR_LOADSTRFAILURE
    A falha função caixa de diálogo comum para carregar um seqüência de caracteres especificado.
  • CDERR_MEMALLOCFAILURE
    A função caixa de diálogo comum foi possível alocar memória para estruturas internas.
  • 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 correspondente identificador instância.
  • 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 uma correspondente procedimento gancho.
  • 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_REGISTRYFAILURE
    A função caixa de diálogo comum Não foi possível ler do Registro.
  • CDERR_STRUCTSIZE
    O lStructSize membro da estrutura de inicialização para o correspondente caixa de diálogo comum é inválido.

O seguinte códigos de erro podem ser retornados para o ChooseFont função:

  • CFERR_MAXLESSTHANMIN
    O tamanho especificado na nSizeMax membro de CHOOSEFONT (estrutura) é menor do que o tamanho especificado na nSizeMin membro.
  • CFERR_NOFONTS
    Nenhuma fonte existe.

Para Windows incorporado CE

CommDlgExtendedError Retorna o erro mais recente para ocorrer durante a execução de um das seguinte funções caixa de diálogo comum:

O seguinte códigos de erro podem ser retornados para o PrintDlg função em Windows Embedded CE:

  • PDERR_CREATEDCFAILURE
    A chamar para Erro falha.
  • PDERR_NOPORTS
    Há Portas são registradas.
  • PDERR_NOPRINTERS
    Nenhuma impressora é registrada.
  • PDERR_PRINTERNOTFOUND
    A seção [dispositivos] do arquivo Win.ini não continha uma entrada para a impressora solicitada.

Requirements

Header commctrl.h
Library commdlg.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ChooseColor (function)
ChooseFont (function)
DialogBox
PageSetupDlg (function)
PrintDlg (function)
CHOOSEFONT (structure)