CoMarshalHresult
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função controla um HRESULT para a transmitir especificada, do qual ele pode ser unmarshaled usando o CoUnmarshalHresult função.
Syntax
STDAPI CoMarshalHresult(
IStream* pStm,
HRESULT hresult
);
Parameters
- pStm
[no] Ponteiro para transmitir o empacotamento.
- HRESULT
[no] HRESULT no processo de origem.
Return Value
O padrão oferece suporte a essa função retornar valores E_OUTOFMEMORY e E_UNEXPECTED, bem como o seguinte:
- S_OK
O HRESULT foi empacotado com êxito.
- STG_E_INVALIDPOINTER
Ponteiro incorreto passados para pStm.
- STG_E_MEDIUMFULL
A mídia está cheia.
Remarks
Um HRESULT é processo-específicos, portanto, um HRESULT que é válido em um processo pode não ser válido no outro.
Se você estiver escrevendo seu próprio implementação de IMarshal e precisa empacotar um HRESULT de um processo para outro, como um parâmetro ou um código de retorno, seu aplicativo precisa chamar essa função. Em outras circunstâncias, o aplicativo não é necessário chamar essa função.
Esta função executa a seguinte tarefas:
- Grava um HRESULT um transmitir.
- Retorna um IStream ponteiro para que transmitir.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | objbase.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |