RpcErrorClearInformation 함수(rpcasync.h)
RpcErrorClearInformation 함수는 현재 스레드에 대한 모든 확장된 오류 정보를 지웁니다.
구문
void RpcErrorClearInformation();
반환 값
이 함수에는 반환 값이 없습니다.
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
설명
RPC 런타임은 일반적으로 확장 오류 정보의 지우기를 처리합니다. 호출자는 두 가지 경우에만 RpcErrorClearInformation을 사용해야 합니다.
- 호출 구성 요소가 RpcErrorAddRecord 함수를 사용하여 스레드에 레코드를 추가하는 경우 심각한 오류가 발생하지 않았다고 결정하고 원본 처리를 계속하거나 레코드에 연결되지 않은 오류가 추가되었습니다. 이 경우 호출 구성 요소는 잠재적으로 오해의 소지가 있는 오류 정보가 전파되지 않도록 스레드에서 오류 정보를 지워야 합니다.
- 호출 구성 요소가 확장된 오류 정보를 반환하는 작업의 여러 재시도를 시도하는 경우 RPC 호출이 시작되면 RPC 런타임은 스레드에 대한 확장된 오류 정보를 지웁니다. 그러나 호출 구성 요소가 반복이 많은 루프에서 RpcErrorAddRecord 를 호출하는 경우 시간이 지남에 따라 확장된 오류 정보가 누적되고 사용 가능한 메모리가 소진 될 수 있으므로 오류 정보를 지우는 것이 좋습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | rpcasync.h(Rpc.h 포함) |
| 라이브러리 | Rpcrt4.lib |
| DLL | Rpcrt4.dll |