Funzione RpcErrorClearInformation (rpcasync.h)
La funzione RpcErrorClearInformation cancella tutte le informazioni di errore estese sul thread corrente.
Sintassi
void RpcErrorClearInformation();
Valore restituito
Questa funzione non ha valori restituiti.
Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.
Commenti
Il runtime RPC gestisce in genere la cancellazione delle informazioni sugli errori estese. In soli due casi i chiamanti devono usare RpcErrorClearInformation:
- Se il componente chiamante aggiunge record al thread usando la funzione RpcErrorAddRecord , decide che non ha rilevato un errore irreversibile e continua l'elaborazione dell'originale oppure l'errore non è connesso ai record viene aggiunto. In questo caso, il componente chiamante deve cancellare le informazioni sull'errore dal thread per impedire la propagazione di informazioni sugli errori potenzialmente fuorvianti.
- Se il componente chiamante tenta più tentativi di un'operazione che restituisce informazioni sull'errore estese. All'avvio di una chiamata RPC, il runtime RPC cancella tutte le informazioni sull'errore estese nel thread. Tuttavia, se il componente chiama rpcErrorAddRecord in un ciclo con molte iterazioni, può essere necessario cancellare le informazioni sull'errore, poiché le informazioni sull'errore estese si accumulano nel tempo e possono esaurire la memoria disponibile.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | rpcasync.h (include Rpc.h) |
| Libreria | Rpcrt4.lib |
| DLL | Rpcrt4.dll |