CDC::SetAbortProc 

int SetAbortProc ( BOOL ( CALLBACK exportação * lpfn ) ( HDC, int ) );

Valor de retorno

Especifica o resultado da função SetAbortProc . Alguns dos valores a seguir são mais prováveis do que outros, mas todos são possíveis.

• SP_ERROR   Erro geral.
  
  
• SP_OUTOFDISKnbsp;  &Não suficiente espaço em disco está atualmente disponível para o spool, e não mais espaço ficará disponível.
  
  
• SP_OUTOFMEMORYnbsp;  &Não há memória suficiente está disponível para o spool.
  
  
• SP_USERABORT   Usuário terminou the job through the Imprimir Manager.

Parâmetros

lpfn

Um ponteiro para a função de anular para instalar como o procedimento de anular. Para obter mais informações sobre o função callback, consulte a Função de retorno de chamada para CDC:: SetAbortProc.

Observações

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

Se um aplicativo é permitir que o trabalho de impressão para ser cancelado durante spool, ele deve definir a função de anular antes que o trabalho de impressão é iniciado com a função de membro StartDoc . O Gerenciador de impressão chama a função de anular durante spool para permitir que o aplicativo para cancelar o trabalho de impressão ou ao processo de condições de falta de espaço de disco. Se nenhuma função abort é definida, o trabalho de impressão irá falhar se não houver 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 a função de membro EnumObjects é um ponteiro para uma função exportada com dllexport e com stdcall Convenção de chamada.

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

BOOL Retorno de chamada Exportação AFunction ( HDC, int );

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

Retorno de chamada registro interfaces agora são tipo-safe (você deve passar em um ponteiro de função que aponta para o direito tipo 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, uma vez que exceções não podem ser lançadas através de limites de retorno de chamada. Para obter mais informações sobre exceções, consulte o artigo exceções no Guia do programador do Visual C++.

Visão geral do CDC |  Membros de classe | Gráfico de hierarquia