Compartilhar via


CDC::SetAbortProc

Instala 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 do SetAbortProc função. Alguns dos seguintes valores são mais prováveis que outros, mas todas são possíveis.

  • SP_ERROR   Erro geral.

  • SP_OUTOFDISK   Não há espaço suficiente em disco é atualmente disponíveis para o spool, e não há mais espaço ficará disponível.

  • SP_OUTOFMEMORY   Não há memória suficiente está disponível para o spool.

  • SP_USERABORT   Usuário terminou o trabalho por meio do Gerenciador de impressão.

Comentários

Se um aplicativo é permitir que o trabalho de impressão a ser cancelada durante o spool, ele deve conjunto a função de anulação antes que o trabalho de impressão é iniciado com o StartDocfunção de membro .O Gerenciador de impressão chama a função de anulação durante spool para permitir que o aplicativo para cancelar o trabalho de impressão ou para processar as condições de insuficiência de espaço em disco.Se nenhuma função anulação conjunto, o trabalho de impressão irá falhar se não há espaço em disco suficiente para o spool.

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

Também não é necessário exportar o nome da função em um EXPORTAÇÕES demonstrativo no arquivo de definição de módulo do aplicativo.Você pode usar o EXPORTAR funcionar modificador, sistema autônomo em

BOOL CALLBACK EXPORT AFunction( HDC, int );

Para fazer com que o compilador emita o registro de exportar adequado exportar por nome sem alias.Isso funciona para a maioria das necessidades.Em alguns casos especiais sistema autônomo exportar uma função por ordinal ou serrilhado a exportação, você ainda precisará usar um EXPORTAÇÕES demonstrativo em um arquivo de definição de módulo.

Interfaces de inscrição de retorno de chamada agora são seguros (você deve passar um ponteiro de função que aponta para o tipo certo 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 Microsoft Foundation antes de retornar ao Windows, como exceções não podem ser lançadas nos limites de retorno de chamada.Para obter mais informações sobre exceções, consulte o artigo Exceções.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CDC

Gráfico de hierarquia

Outros recursos

Membros do CDC