CoRegisterSurrogate

Registers the surrogate process through its ISurrogate interface pointer.

HRESULT CoRegisterSurrogate(
  ISurrogate  * pSurrogate  //ISurrogate pointer on the process to 
                            // be registered
);
 

Parameter

pSurrogate

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

Return Value

S_OK

The surrogate process was registered.

Remarks

The CoRegisterSurrogate function sets a global interface pointer to the ISurrogate interface 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.

QuickInfo

  Windows NT: Use version 4.0 SP2 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in objbase.h.
  Import Library: Included as a resource in ole32.dll.

See Also

ISurrogate, Writing a Custom Surrogate