Función CoMarshalHresult (combaseapi.h)

Serializa un HRESULT en la secuencia especificada, desde la que se puede desmarshalar mediante la función CoUnmarshalHresult .

Sintaxis

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

Parámetros

[in] pstm

Puntero al flujo de cálculo de referencias. Mira IStream.

[in] hresult

HRESULT en el proceso de origen.

Valor devuelto

Esta función puede devolver los valores devueltos estándar E_OUTOFMEMORY y E_UNEXPECTED, así como los siguientes valores.

Código devuelto	Descripción
S_OK	HrESULT se serializó correctamente.
STG_E_INVALIDPOINTER	Se especificó un puntero incorrecto para pstm.
STG_E_MEDIUMFULL	El medio está lleno.

Comentarios

Un HRESULT es específico del proceso, por lo que es posible que un HRESULT que sea válido en un proceso no sea válido en otro. Si está escribiendo su propia implementación de IMarshal y necesita serializar un HRESULT de un proceso a otro, ya sea como un parámetro o un código de retorno, debe llamar a esta función. En otras circunstancias, no tendrá que llamar a esta función.

Esta función realiza las siguientes tareas:

1. Escribe un HRESULT en una secuencia.
2. Devuelve un puntero IStream a esa secuencia.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	combaseapi.h (incluya Objbase.h)
Library	Ole32.lib
Archivo DLL	Ole32.dll

Consulte también

CoUnmarshalHresult

Istream