Compartir a través de

Función CoMarshalHresult (combaseapi.h)

  • Artículo

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