Funzione CoMarshalInterface (combaseapi.h)

Articolo
08/22/2023

Scrive in un flusso i dati necessari per inizializzare un oggetto proxy in un processo client.

Sintassi

HRESULT CoMarshalInterface(
  [in]           LPSTREAM  pStm,
  [in]           REFIID    riid,
  [in]           LPUNKNOWN pUnk,
  [in]           DWORD     dwDestContext,
  [in, optional] LPVOID    pvDestContext,
  [in]           DWORD     mshlflags
);

Parametri

[in] pStm

Puntatore al flusso da usare durante il marshalling. Vedere IStream.

[in] riid

Riferimento all'identificatore dell'interfaccia da eseguire per il marshalling. Questa interfaccia deve essere derivata dall'interfaccia IUnknown .

[in] pUnk

Puntatore all'interfaccia da eseguire il marshalling. Questa interfaccia deve essere derivata dall'interfaccia IUnknown .

[in] dwDestContext

Contesto di destinazione in cui l'interfaccia specificata deve essere annullata. I valori possibili provengono dall'enumerazione MSHCTX. Attualmente, unmarshaling può verificarsi in un altro appartamento del processo corrente (MSHCTX_INPROC), in un altro processo nello stesso computer del processo corrente (MSHCTX_LOCAL) o in un processo in un computer diverso (MSHCTX_DIFFERENTMACHINE).

[in, optional] pvDestContext

Questo parametro è riservato e deve essere NULL.

[in] mshlflags

I flag che specificano se i dati da eseguire per il marshalling devono essere trasmessi al processo client (il caso tipico) o scritti in una tabella globale, in cui può essere recuperato da più client. I valori possibili provengono dall'enumerazione MSHLFLAGS .

Valore restituito

Questa funzione può restituire i valori restituiti standard E_FAIL, E_OUTOFMEMORY e E_UNEXPECTED, i valori di errore di accesso al flusso restituiti da IStream e i valori seguenti.

Codice restituito	Descrizione
S_OK	HrESULT è stato eseguito correttamente il marshalling.
CO_E_NOTINITIALIZED	La funzione CoInitialize o OleInitialize non è stata chiamata nel thread corrente prima che questa funzione sia stata chiamata.

Commenti

La funzione CoMarshalInterface esegue il marshalling dell'interfaccia a cui fa riferimento riid nell'oggetto la cui implementazione IUnknown è puntata da pUnk. A tale scopo, la funzione CoMarshalInterface esegue le attività seguenti:

Esegue una query sull'oggetto per un puntatore all'interfaccia IMarshal . Se l'oggetto non implementa IMarshal, ovvero si basa su COM per fornire supporto di marshalling, CoMarshalInterface ottiene un puntatore all'implementazione predefinita di IMarshal.
Ottiene il CLSID del proxy dell'oggetto chiamando IMarshal::GetUnmarshalClass, usando il puntatore dell'interfaccia IMarshal restituito.
Scrive il CLSID del proxy nel flusso da usare per il marshalling.
Esegue il marshalling del puntatore dell'interfaccia chiamando IMarshal::MarshalInterface.

La libreria COM nel processo client chiama la funzione CoUnmarshalInterface per estrarre i dati e inizializzare il proxy. Prima di chiamare CoUnmarshalInterface, cercare di tornare alla posizione originale nel flusso.

Se si implementano interfacce COM esistenti o si definiscono le proprie interfacce usando Microsoft Interface Definition Language (MIDL), i proxy generati da MIDL e gli stub chiamano CoMarshalInterface . Se si scrivono proxy e stub, il codice proxy e il codice stub devono ogni chiamata a CoMarshalInterface per eseguire correttamente il marshalling dei puntatori dell'interfaccia. Non è consigliabile chiamare IMarshal direttamente dal proxy e dal codice stub.

Se si scrive la propria implementazione di IMarshal e il proxy deve accedere a un oggetto privato, è possibile includere un puntatore dell'interfaccia a tale oggetto come parte dei dati scritti nel flusso. In tali situazioni, se si vuole usare l'implementazione predefinita del marshalling COM quando si passa il puntatore dell'interfaccia, è possibile chiamare CoMarshalInterface nell'oggetto a tale scopo.

Requisiti


Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	combaseapi.h (include Objbase.h)
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

CoUnmarshalInterface

IMarshal::MarshalInterface

Condividi tramite