Skip to content

Latest commit

 

History

History
121 lines (95 loc) · 4.01 KB

nf-combaseapi-cogetstdmarshalex.md

File metadata and controls

121 lines (95 loc) · 4.01 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:combaseapi.CoGetStdMarshalEx
CoGetStdMarshalEx function (combaseapi.h)
Creates an aggregated standard marshaler for use with lightweight client-side handlers.
CoGetStdMarshalEx
CoGetStdMarshalEx function [COM]
SMEXF_HANDLER
SMEXF_SERVER
_com_CoGetStdMarshalEx
com.cogetstdmarshalex
combaseapi/CoGetStdMarshalEx
com\cogetstdmarshalex.htm
com
405c5ff3-8702-48b3-9be9-df4a9461696e
12/05/2018
CoGetStdMarshalEx, CoGetStdMarshalEx function [COM], SMEXF_HANDLER, SMEXF_SERVER, _com_CoGetStdMarshalEx, com.cogetstdmarshalex, combaseapi/CoGetStdMarshalEx
combaseapi.h
Objbase.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Ole32.lib
Ole32.dll
Windows
19H1
CoGetStdMarshalEx
combaseapi/CoGetStdMarshalEx
c++
APIRef
kbSyntax
DllExport
Ole32.dll
API-MS-Win-Core-Com-l1-1-0.dll
ComBase.dll
API-MS-Win-Core-Com-l1-1-1.dll
API-MS-Win-DownLevel-Ole32-l1-1-0.dll
API-MS-Win-DownLevel-Ole32-l1-1-1.dll
CoGetStdMarshalEx

CoGetStdMarshalEx function

-description

Creates an aggregated standard marshaler for use with lightweight client-side handlers.

-parameters

-param pUnkOuter [in]

A pointer to the controlling IUnknown.

-param smexflags [in]

One of two values indicating whether the aggregated standard marshaler is on the client side or the server side. These flags are defined in the STDMSHLFLAGS enumeration.

Value Meaning
SMEXF_SERVER
0x01
Indicates a server-side aggregated standard marshaler.
SMEXF_HANDLER
0x0
Indicates a client-side (handler) aggregated standard marshaler.

-param ppUnkInner [out]

On successful return, address of pointer to the IUnknown interface on the newly-created aggregated standard marshaler. If an error occurs, this value is NULL.

-returns

This function returns S_OK.

-remarks

The server calls CoGetStdMarshalEx passing in the flag SMEXF_SERVER. This creates a server side standard marshaler (known as a stub manager). The handler calls CoGetStdMarshalEx passing in the flag SMEXF_HANDLER. This creates a client side standard marshaler (known as a proxy manager). Note that when calling this function, the handler must pass the original controlling unknown that was passed to the handler when the handler was created. This will be the system implemented controlling unknown. Failure to pass the correct IUnknown results in an error returned. On success, the ppUnkInner returned is the controlling unknown of the inner object. The server and handler must keep this pointer, and may use it to call IUnknown::QueryInterface for the IMarshal interface.

-see-also

IMarshal

IStdMarshalInfo

The Lightweight Client-Side Handler