Функция RpcErrorClearInformation (rpcasync.h)
Функция RpcErrorClearInformation очищает все расширенные сведения об ошибках в текущем потоке.
Синтаксис
void RpcErrorClearInformation();
Возвращаемое значение
Эта функция не имеет возвращаемых значений.
Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.
Комментарии
Среда выполнения RPC обычно обрабатывает очистку расширенных сведений об ошибках. Только в двух случаях вызывающие должны использовать RpcErrorClearInformation:
- Если вызывающий компонент добавляет записи в поток с помощью функции RpcErrorAddRecord , то он решает, что не произошла неустранимая ошибка и продолжает обработку исходного, или ошибка не подключена к записям. В этом случае вызывающему компоненту необходимо очистить сведения об ошибке из потока, чтобы предотвратить распространение потенциально вводящих в заблуждение сведений об ошибках.
- Если вызывающий компонент пытается выполнить несколько повторных попыток операции, возвращающей расширенные сведения об ошибке. При запуске вызова RPC среда выполнения RPC очищает все расширенные сведения об ошибках в потоке. Однако если вызывающий компонент вызывает RpcErrorAddRecord в цикле с большим количеством итераций, ему может потребоваться очистить сведения об ошибке, так как расширенные сведения об ошибках накапливаются со временем и могут исчерпать доступную память.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | rpcasync.h (включая Rpc.h) |
| Библиотека | Rpcrt4.lib |
| DLL | Rpcrt4.dll |