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 |