Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function registers the surrogate process through its ISurrogateinterface pointer.

Syntax 

HRESULT CoRegisterSurrogate(
  ISurrogate* 
pSurrogate
);

Parameters

pSurrogate

[in] Pointer to the ISurrogateinterface on the surrogate process to be registered.

Return Value

S_OK

The surrogate process was registered.

Remarks

The CoRegisterSurrogatefunction sets a global interface pointer to the ISurrogateinterface implemented on the surrogate process. This pointer is set in the ole32 DLL loaded in the surrogate process. COM uses this global pointer in ole32 to call the methods of ISurrogate.

This function is usually called by the surrogate implementation when it is launched.

To determine whether the platform supports this function, see Determining Supported 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