Compartilhar via


_RTC_SetErrorFuncW

Designa uma função como o manipulador para relatar RTCs (verificações de erro em tempo de execução).

Sintaxe

_RTC_error_fnW _RTC_SetErrorFuncW(
   _RTC_error_fnW function
);

Parâmetros

function
O endereço da função que manipulará verificações de erro em tempo de execução.

Valor retornado

A função de erro definida anteriormente; ou NULL se não houver nenhuma função definida anteriormente.

Comentários

Use apenas _RTC_SetErrorFuncW no novo código. _RTC_SetErrorFunc só é incluída na biblioteca para fins de compatibilidade com versões anteriores.

O retorno de chamada _RTC_SetErrorFuncW se aplica somente ao componente ao qual ele estava vinculado, não globalmente.

Verifique se o endereço que você passa para _RTC_SetErrorFuncW pertence a uma função de tratamento de erro válida.

Se um erro tiver sido atribuído a um tipo de -1 usando _RTC_SetErrorType, a função de tratamento de erros não será chamada.

Antes de chamar essa função, você deve chamar primeiro uma das funções de inicialização de verificação de erro em tempo de execução. Para obter mais informações, consulte Usando verificações de tempo de execução sem a biblioteca de tempo de execução C.

_RTC_error_fnW é definido da seguinte forma:

typedef int (__cdecl * _RTC_error_fnW)(
    int errorType,
    const wchar_t * filename,
    int linenumber,
    const wchar_t * moduleName,
    const wchar_t * format,
    ... );

em que:

errorType
O tipo de erro especificado por _RTC_SetErrorType.

filename
O arquivo de origem no qual a falha ocorreu ou nulo se nenhuma informação de depuração estiver disponível.

linenumber
A linha em filename que ocorreu a falha ou 0 se nenhuma informação de depuração estiver disponível.

moduleName
A DLL ou o nome do executável em que a falha ocorreu.

format
A cadeia de estilo printf para exibir uma mensagem de erro usando os parâmetros restantes. O primeiro argumento do VA_ARGLIST é o número de erro RTC que ocorreu.

Para obter um exemplo que mostra como usar _RTC_error_fnWo , consulte Personalização de verificações de tempo de execução nativo.

Requisitos

Rotina Cabeçalho necessário
_RTC_SetErrorFuncW <rtcapi.h>

Para obter mais informações, consulte Compatibilidade.

Bibliotecas

Todas as versões das bibliotecas em tempo de execução C.

Confira também

_CrtDbgReport, _CrtDbgReportW
Verificação de erros de runtime