_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_fnW
o , 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