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

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

  • Статья

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