CoMarshalHresult-Funktion (combaseapi.h)

  • Artikel

Marshallt ein HRESULT in den angegebenen Stream, aus dem es mithilfe der CoUnmarshalHresult-Funktion aufgehoben werden kann.

Syntax

HRESULT CoMarshalHresult(
  [in] LPSTREAM pstm,
  [in] HRESULT  hresult
);

Parameter

[in] pstm

Ein Zeiger auf den Marshalldatenstrom. Siehe IStream.

[in] hresult

Das HRESULT im Ursprungsprozess.

Rückgabewert

Diese Funktion kann die Standardrückgabewerte E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Das HRESULT wurde erfolgreich gemarst.
STG_E_INVALIDPOINTER
 Für pstm wurde ein fehlerhafter Zeiger angegeben.
STG_E_MEDIUMFULL
 Das Medium ist voll.

Hinweise

Ein HRESULT ist prozessspezifisch, sodass ein HRESULT , das in einem Prozess gültig ist, in einem anderen möglicherweise nicht gültig ist. Wenn Sie Ihre eigene Implementierung von IMarshal schreiben und ein HRESULT von einem Prozess in einen anderen marshallen müssen, entweder als Parameter oder als Rückgabecode, müssen Sie diese Funktion aufrufen. Unter anderen Umständen müssen Sie diese Funktion nicht aufrufen.

Diese Funktion führt die folgenden Aufgaben aus:

  1. Schreibt ein HRESULT in einen Stream.
  2. Gibt einen IStream-Zeiger auf diesen Stream zurück.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile combaseapi.h (include Objbase.h)
Bibliothek Ole32.lib
DLL Ole32.dll

Weitere Informationen

CoUnmarshalHresult

IStream