Funzione RpcErrorClearInformation (rpcasync.h)

  • Articolo

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

Vedi anche

Recupero delle informazioni sugli errori RPC estese

RpcErrorAddRecord

RpcErrorGetNextRecord

RpcErrorStartEnumeration