_RTC_SetErrorFuncW
Designa uma função como o manipulador para o relatório das verificações de erro em tempo de execução (RTC).
_RTC_error_fnW _RTC_SetErrorFuncW(
_RTC_error_fnW function
);
Parâmetros
- function
O endereço da função que tratará verificações de erro em tempo de execução.
Valor de retorno
A função de erro definida anteriormente; NULL ou se não houver nenhuma função definida anteriormente.
Comentários
No novo código, use somente _RTC_SetErrorFuncW. _RTC_SetErrorFunc só será incluído na biblioteca para compatibilidade com versões anteriores.
O retorno de chamada de _RTC_SetErrorFuncW aplica-se apenas ao componente que esteve vinculado no, mas não global.
Certifique-se de que o endereço que você passa a _RTC_SetErrorFuncW é o de uma função válidos de tratamento de erros.
Se um erro foi atribuído um tipo de _RTC_SetErrorType, 1 – usando a função de tratamento de erros não será chamado.
Antes que você possa chamar essa função, é necessário o primeiro chame um das funções de inicialização da verificação de erro de tempo de execução. Para obter mais informações, consulte Usando verificações de tempo de execução sem a biblioteca em tempo de execução do C.
_RTC_error_fnW é definido da seguinte forma:
typedef int (__cdecl *_RTC_error_fnW)(int errorType**, const wchar_t *nome do arquivo, int** linenumber**, const wchar_t *moduleName, const wchar_t *formato, ...);**
onde:
errorType
O tipo de erro que é especificado por _RTC_SetErrorType.filename
O arquivo de origem onde a falha ocorreu, ou nulo se nenhuma informação de depuração está disponível.linenumber
A linha no nome de arquivo onde a falha ocorreu, ou 0 se nenhuma informação de depuração está disponível.moduleName
O nome da DLL ou do executável onde a falha ocorreu.format
cadeia de caracteres de estilo de printf para exibir uma mensagem de erro, usando os parâmetros restantes. O primeiro argumento de VA_ARGLIST é o número de erro de RTC que ocorreu.
Para obter um exemplo que mostra como usar _RTC_error_fnW, considere Personalização das verificações de tempo de execução nativas.
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.
Equivalência do .NET Framework
Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.
Consulte também
Referência
Verificação de erros de tempo de execução