RpcErrorSaveErrorInfo-Funktion (rpcasync.h)

  • Artikel

Die RpcErrorSaveErrorInfo-Funktion gibt alle Fehlerinformationen für ein Enumerationshandle als BLOB zurück.

Syntax

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

Parameter

[in] EnumHandle

Zeiger auf das Enumerationshandle.

[out] ErrorBlob

Zeiger auf das BLOB, das die Fehlerinformationen enthält.

[out] BlobSize

Größe von ErrorBlob in Bytes.

Rückgabewert

Erfolgreicher Abschluss gibt RPC_S_OK zurück. Der RpcErrorSaveErrorInfo-Funktionsaufruf schlägt möglicherweise fehl, wenn nicht genügend Arbeitsspeicher verfügbar ist.

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

Das BLOB wird auf dem Systemheap zugeordnet, und der Aufrufer ist der Besitzer des Puffers. Der auf dem Systemheap zugeordnete Block kann größer als BlobSize sein, aber es wird nur BlobSize verwendet. Die RpcErrorSaveErrorInfo-Funktion speichert die gesamte Kette erweiterter Fehlerinformationsdatensätze, die dem Enumerationshandle zugeordnet sind, unabhängig von der Cursorposition, und ändert die Cursorposition für die Enumeration nicht.

Das BLOB kann mithilfe der RpcErrorLoadErrorInfo-Funktion gespeichert und später abgerufen werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile rpcasync.h (rpc.h einschließen)
Bibliothek Rpcrt4.lib
DLL Rpcrt4.dll

Weitere Informationen

Abrufen erweiterter RPC-Fehlerinformationen

RPC_ERROR_ENUM_HANDLE

RpcErrorLoadErrorInfo

RpcErrorStartEnumeration