CoRegisterSurrogateEx

  • Article

Registers the specified surrogate process as a COM+ application. All components configured in the COM+ application are then serviced in the surrogate process.

HRESULT CoRegisterSurrogateEx (
  REFGUID rguidProcessID,
  void * reserved
);

Parameter

  • rguidProcessID
    [in] The ID of the surrogate process, which is used as the application ID for the COM+ application.
  • reserved
    [in] Reserved for future use. Should be null.

Return Value

  • S_OK
    The surrogate process was registered.

Remarks

When an application calls CoRegisterSurrogateEx, its identity must be the same as the identity it specifies in rguidProcessID.

The CoRegisterSurrogateEx function is a blocking function. It does not return until COM+ has determined that the process will be shut down. Before calling this function, initialize COM on this thread as a multi-threaded apartment (MTA).

Requirements

For an explanation of the requirement values, see Requirements (COM).

Windows NT/2000/XP: Requires Windows 2000 or later.

Windows 95/98: Unsupported.

Header: Declared in objbase.h.

Library: Use ole32.lib.

Send comments about this topic to Microsoft.