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

Статья
03/09/2024

Функция RpcErrorSaveErrorInfo возвращает все сведения об ошибках для дескриптора перечисления в виде большого двоичного объекта.

Синтаксис

RPC_STATUS RpcErrorSaveErrorInfo(
  [in]  RPC_ERROR_ENUM_HANDLE *EnumHandle,
  [out] PVOID                 *ErrorBlob,
  [out] size_t                *BlobSize
);

Параметры

[in] EnumHandle

Указатель на дескриптор перечисления.

[out] ErrorBlob

Указатель на большой двоичный объект, содержащий сведения об ошибке.

[out] BlobSize

Размер объекта ErrorBlob в байтах.

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

Успешное завершение возвращает RPC_S_OK. Вызов функции RpcErrorSaveErrorInfo может завершиться ошибкой, если недостаточно памяти.

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

Большой двоичный объект выделяется в системной куче, а вызывающий объект является владельцем буфера. Блок, выделенный в системной куче, может быть больше , чем BlobSize, но используется только BlobSize . Функция RpcErrorSaveErrorInfo сохраняет всю цепочку расширенных записей сведений об ошибках, связанных с дескриптором перечисления, независимо от позиции курсора, и не изменяет позицию курсора для перечисления.

Большой двоичный объект можно сохранить и позже получить с помощью функции RpcErrorLoadErrorInfo .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	rpcasync.h (включая Rpc.h)
Библиотека	Rpcrt4.lib
DLL	Rpcrt4.dll

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

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

RPC_ERROR_ENUM_HANDLE

RpcErrorLoadErrorInfo

RpcErrorStartEnumeration

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