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

Confira também

Obtendo informações de erro de RPC estendidas

RpcErrorAddRecord

RpcErrorGetNextRecord

RpcErrorStartEnumeration