Функция RpcErrorAddRecord (rpcasync.h)

Статья
03/15/2023

Функция RpcErrorAddRecord добавляет расширенные сведения об ошибках в цепочку расширенных записей сведений об ошибках.

Синтаксис

RPC_STATUS RpcErrorAddRecord(
  [in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);

Параметры

[in] ErrorInfo

Добавляемые сведения об ошибке в виде структуры RPC_EXTENDED_ERROR_INFO .

Возвращаемое значение

Успешное завершение возвращает RPC_S_OK.

Примечание Список допустимых кодов ошибок см. в разделе Возвращаемые значения RPC.

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

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

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

RPC_EXTENDED_ERROR_INFO

RpcErrorGetNextRecord

RpcErrorStartEnumeration

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