Compartilhar via

Função CoMarshalHresult (combaseapi.h)

  • Artigo

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