Функция RpcErrorAddRecord (rpcasync.h)
Функция RpcErrorAddRecord добавляет расширенные сведения об ошибках в цепочку расширенных записей сведений об ошибках.
Синтаксис
RPC_STATUS RpcErrorAddRecord(
[in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);
Параметры
[in] ErrorInfo
Добавляемые сведения об ошибке в виде структуры RPC_EXTENDED_ERROR_INFO .
Возвращаемое значение
Успешное завершение возвращает RPC_S_OK.
Комментарии
Функция RpcErrorAddRecord позволяет приложениям или серверам, отличным от среды выполнения RPC, добавлять расширенные сведения об ошибках в цепочку расширенных записей сведений об ошибках.
Ответственность за строки, на которые указывает ErrorInfo, принадлежит вызывающей объекту; При необходимости функция RpcErrorAddRecord создает копию этих строк. Необходимо соблюдать следующие ограничения для членов ErrorInfo :
Для версии должна быть задана допустимая версия, например RPC_EEINFO_VERSION.
Параметр ComputerName должен иметь значение NULL. Любое другое значение приводит к ERROR_INVALID_PARAMETER.
Значение ProcessID должно быть равно нулю. Любое другое значение приводит к ERROR_INVALID_PARAMETER.
SystemTime или FileTime игнорируются при входных данных и задаются средой выполнения RPC.
Для generatingComponent необходимо задать нулевое значение. Любое другое значение приводит к ERROR_INVALID_PARAMETER. Среда выполнения RPC задает для этого параметра значение EEInfoGCApplication.
Состоянием можно задать код ошибки, который вызывающий объект хочет добавить в цепочку.
Параметр DetectionLocation должен иметь нулевое значение. Любое другое значение приводит к ERROR_INVALID_PARAMETER.
NumberOfParameters указывает количество параметров в массиве Parameters. Это значение должно быть равно или больше нуля или MaxNumberOfEEInfoParams. Среда выполнения RPC не использует память после указанного количества параметров, поэтому вызывающие абоненты могут безопасно выделять память для параметров Меньше, чем MaxNumberOfEEInfoParams.
Параметры представляют параметры для расширенной записи сведений об ошибке. Единственным ограничением параметров является то, что Pval используется для представления указателей и всегда имеет значение 64 бита. Используйте Pval независимо от того, используется ли система : 32 или 64 бита. Не используйте Lval.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | rpcasync.h (включая Rpc.h) |
| Библиотека | Rpcrt4.lib |
| DLL | Rpcrt4.dll |