Função RpcErrorClearInformation (rpcasync.h)
A função RpcErrorClearInformation limpa todas as informações de erro estendidas no thread atual.
Sintaxe
void RpcErrorClearInformation();
Retornar valor
Essa função não tem valores retornados.
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
Comentários
O RPC Runtime geralmente manipula a limpeza de informações de erro estendidas. Em apenas dois casos, os chamadores devem usar RpcErrorClearInformation:
- Se o componente de chamada adicionar registros ao thread usando a função RpcErrorAddRecord , ele decidirá que não encontrou um erro fatal e continuará processando o original ou se o erro não estiver conectado aos registros será adicionado. Nesse caso, o componente de chamada precisa limpar as informações de erro do thread para evitar a propagação de informações de erro potencialmente enganosas.
- Se o componente de chamada tentar várias tentativas de uma operação que retorna informações de erro estendidas. Quando uma chamada RPC é iniciada, o RPC Runtime limpa todas as informações de erro estendidas no thread. No entanto, se o componente de chamada chamar RpcErrorAddRecord em um loop com muitas iterações, talvez ele queira limpar as informações de erro, pois as informações de erro estendidas se acumulam ao longo do tempo e podem esgotar a memória disponível.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | rpcasync.h (inclua Rpc.h) |
| Biblioteca | Rpcrt4.lib |
| DLL | Rpcrt4.dll |