Compartilhar via


CDC::SETABORTPROC

Instale o procedimento de anulação para o trabalho de impressão.

int SetAbortProc( 
   BOOL ( CALLBACK* lpfn )( HDC, int ) 
);

Parâmetros

Valor de retorno

Especifica o resultado da função de SetAbortProc . Alguns dos seguintes valores são mais prováveis do que outras pessoas, mas todos são possíveis.

  • Erro de gerais deSP_ERROR .

  • SP_OUTOFDISK não espaço suficiente em disco está disponível no momento para rolar, e não será mais espaço disponível.

  • SP_OUTOFMEMORY memória suficiente não está disponível para rolar.

  • O usuário terminou deSP_USERABORT funciona através do gerenciador de impressão.

Comentários

Se um aplicativo é permitir que o trabalho de impressão serão canceladas durante o enfileiramento, deve definir a função antes de abort que o trabalho de impressão são iniciados com a função de membro de StartDoc . O gerenciador de impressão chama a função de abort o durante rolagem para permitir que o aplicativo cancelar o trabalho de impressão ou processar condições fora de rígido espaço. Se nenhuma função é definida de abort, o trabalho de impressão irão falhar se não há espaço suficiente em disco para rolar.

Observe que os recursos Microsoft Visual C++ simplificam a criação de função de retorno de chamada passada para SetAbortProc. O endereço passado à função de membro de EnumObjects é um ponteiro para uma função exportada com __declspec(dllexport) e com __stdcall que chama a convenção.

Você também não precisa exportar o nome de função em uma instrução de EXPORTS módulo no arquivo de definição do seu aplicativo. Você pode usar o modificador da função de EXPORTAR , como em

BOOLCALLBACKEXPORTAR AFunction( HDC, int**);**

para fazer com que o compilador emitir o registro adequado de exportação para exportação por nome sem serrilha. Isso funciona para a maioria precisa. Para alguns casos especiais, como exportar uma função por ordinal ou por serrilha exportação, você ainda precisará usar uma instrução de EXPORTS em um arquivo de módulo definição.

As interfaces de registro de retorno de chamada agora são fortemente tipadas (você deve passar em um ponteiro de função que aponta para o tipo correto de função para o retorno de chamada específico).

Observe também que todas as funções de retorno de chamada devem interceptar exceções de Microsoft foundation antes de retornar ao, desde que as exceções não podem ser lançadas através dos limites de retorno de chamada. Para obter mais informações sobre as exceções, consulte o artigo Exceções.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CDC Class

Gráfico da hierarquia