Función RpcErrorClearInformation (rpcasync.h)
La función RpcErrorClearInformation borra toda la información de error extendida en el subproceso actual.
Sintaxis
void RpcErrorClearInformation();
Valor devuelto
Esta función no tiene valores devueltos.
Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.
Comentarios
El tiempo de ejecución de RPC normalmente controla el borrado de información de error extendida. En solo dos casos, los autores de llamadas deben usar RpcErrorClearInformation:
- Si el componente que realiza la llamada agrega registros al subproceso mediante la función RpcErrorAddRecord , decide que no ha encontrado un error irrecuperable y continúa procesando el original o el error no está conectado a los registros se ha agregado. En este caso, el componente de llamada debe borrar la información de error del subproceso para evitar la propagación de información de error potencialmente engañosa.
- Si el componente que realiza la llamada intenta varios reintentos de una operación que devuelve información de error extendida. Cuando se inicia una llamada RPC, rpc runtime borra cualquier información de error extendida en el subproceso. Sin embargo, si el componente de llamada llama a RpcErrorAddRecord en un bucle con muchas iteraciones, puede que desee borrar la información de error, ya que la información de error extendida se acumula con el tiempo y puede agotar la memoria disponible.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | rpcasync.h (include Rpc.h) |
| Library | Rpcrt4.lib |
| Archivo DLL | Rpcrt4.dll |