RpcErrorClearInformation 関数 (rpcasync.h)

RpcErrorClearInformation 関数は、現在のスレッドのすべての拡張エラー情報をクリアします。

構文

void RpcErrorClearInformation();

この関数には戻り値がありません。

メモ有効なエラーコードの一覧については、「 RPC 戻り値」を参照してください。

RPC ランタイムは通常、拡張エラー情報のクリアを処理します。呼び出し元は RpcErrorClearInformation を使用する必要があるケースは 2 つだけです。

呼び出し元コンポーネントが RpcErrorAddRecord 関数を使用してスレッドにレコードを追加した場合、致命的なエラーが発生していないと判断し、元の処理を続行するか、エラーが追加されたレコードに接続されていません。この場合、呼び出し元コンポーネントは、誤解を招く可能性のあるエラー情報の伝達を防ぐために、スレッドからエラー情報をクリアする必要があります。
呼び出し元コンポーネントが、拡張エラー情報を返す操作を複数回再試行する場合。 RPC 呼び出しが開始されると、RPC ランタイムはスレッドの拡張エラー情報をクリアします。ただし、呼び出し元コンポーネントが繰り返し回数の多いループで RpcErrorAddRecord を呼び出す場合は、時間の経過と共に拡張エラー情報が蓄積され、使用可能なメモリが使い果たされる可能性があるため、エラー情報をクリアすることが必要な場合があります。

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	rpcasync.h (Rpc.h を含む)
Library	Rpcrt4.lib
[DLL]	Rpcrt4.dll