CoMarshalHresult-Funktion (combaseapi.h)
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 |
|---|---|
|
Das HRESULT wurde erfolgreich gemarst. |
|
Für pstm wurde ein fehlerhafter Zeiger angegeben. |
|
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:
- Schreibt ein HRESULT in einen Stream.
- 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 |