Library Functions - sm_mts_CreateInstance (Programming Guide)

Programming Guide

sm_mts_CreateInstance

Creates an object under MTS control
int sm_mts_CreateInstance( char *name );
name
Name of object to be created.

Environment

MTS

Scope

Server

Returns

· An object id suitable for making sm_obj_call calls.

· In case of error, PR_E_OBJECT will be returned and a notation with the HRESULT written to the log file.

Description

sm_mts_CreateInstance can be used in place of sm_obj_create to create an object that inherits the transaction context from the calling service object.
For more details see CreateInstance method under IObjectContextMethods in the MTS documentation.
Note that this function requires an object context and therefore cannot be used in the constructor of a service component.