CoMarshalInterThreadInterfaceInStream
.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 ponteiro interface de um segmento para outro segmento no mesmo processo.
Syntax
HRESULT CoMarshalInterThreadInterfaceInStream(
REFIID riid,
LPUNKNOWN pUnk,
LPSTREAM* ppStm
);
Parameters
- riid
[no] Referência ao identificador da interface para ser empacotado.
- pUnk
[no] Ponteiro para a interface para ser empacotado, que deve ser derivado de IUnknown; pode ser NULL.
- ppStm
[out] Endereço do IStreamvariável * pointer que recebe o ponteiro interface para a transmitir que contém a interface empacotado.
Return Value
Essa função suporta o padrão valor de retorno E_OUTOFMEMORY, bem como o seguinte:
- S_OK
A interface foi empacotado com êxito.
Remarks
O CoMarshalInterThreadInterfaceInStream função permite que um objeto para fácil e confiável empacotar um ponteiro interface para outro segmento no mesmo processo.
A transmitir retornados em ppStm é garantida para se comportam corretamente quando um cliente execução no segmento de recepção tenta desempacotar o ponteiro. O cliente pode então chamar o CoGetInterfaceAndReleaseStream Para desempacotar o ponteiro interface e o objeto transmitir versão.
O CoMarshalInterThreadInterfaceInStream função executa a seguinte tarefas:
- Cria um objeto transmitir.
- Passa do o objeto de fluxo IStream ponteiro para CoMarshalInterface.
- Retorna o IStream ponteiro para o chamador.
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 |