Поделиться через

Функция 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

См. также раздел

Получение сведений об ошибке расширенного RPC

RpcErrorAddRecord

RpcErrorGetNextRecord

RpcErrorStartEnumeration