CoGetInterfaceAndReleaseStream

9/8/2008

Essa função unmarshals uma reserva que contém um ponteiro interface e libera a transmitir quando um ponteiro interface foi empacotado do outro segmento para o segmento chamado.

Syntax

HRESULT CoGetInterfaceAndReleaseStream(
  LPSTREAM pStm,
  REFIID riid,
  LPVOID* ppv
);

Parameters

• pStm
  [no] Ponteiro para o IStream interface sobre a transmitir ser unmarshaled.

• riid
  [no] Referência ao identificador da interface solicitada do objeto unmarshaled.

• PPV
  [out] Endereço do ponteiro variável que recebe o ponteiro interface solicitado no riid. Após bem-sucedido retornar *PPV Contém o ponteiro interface solicitada para a interface unmarshaled.

Return Value

Essa função suporta o padrão valor de retorno E_INVALIDARG, bem como o seguinte:

• S_OK
  Indica a interface saída foi unmarshaled e a transmitir foi lançado.

Essa função também pode retornar qualquer um dos valores retornados pela CoUnmarshalInterface.

Remarks

O CoGetInterfaceAndReleaseStream função executa a seguinte tarefas:

1. Chamadas CoUnmarshalInterface Para desempacotar um ponteiro interface anteriormente passado um chamar para CoMarshalInterThreadInterfaceInStream.
2. Libera o ponteiro transmitir. Mesmo se o desempacotamento falha, a transmitir ainda é lançada porque não há nenhuma maneira eficaz se recuperar de uma falha desse tipo.

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

See Also

Reference

COM Functions