Função CoMarshalHresult (combaseapi.h)

Faz marshaling de um HRESULT para o fluxo especificado, do qual ele pode ser unmarshaled usando a função CoUnmarshalHresult .

Sintaxe

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

Parâmetros

[in] pstm

Um ponteiro para o fluxo de marshaling. Consulte IStream.

[in] hresult

O HRESULT no processo de origem.

Retornar valor

Essa função pode retornar os valores de retorno padrão E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno	Descrição
S_OK	O HRESULT foi realizado com êxito.
STG_E_INVALIDPOINTER	Um ponteiro inválido foi especificado para pstm.
STG_E_MEDIUMFULL	O meio está cheio.

Comentários

Um HRESULT é específico do processo, portanto, um HRESULT válido em um processo pode não ser válido em outro. Se você estiver escrevendo sua própria implementação do IMarshal e precisar realizar marshaling de um HRESULT de um processo para outro, como um parâmetro ou um código de retorno, deverá chamar essa função. Em outras circunstâncias, você não precisará chamar essa função.

Essa função executa as seguintes tarefas:

1. Grava um HRESULT em um fluxo.
2. Retorna um ponteiro IStream para esse fluxo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	combaseapi.h (inclua Objbase.h)
Biblioteca	Ole32.lib
DLL	Ole32.dll

Confira também

CoUnmarshalHresult

Istream