IRunningObjectTable.Register(Int32, Object, IMoniker) Method

Reference

Definition

Namespace:: System.Runtime.InteropServices.ComTypes

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Registers that the supplied object has entered the running state.

public:
 int Register(int grfFlags, System::Object ^ punkObject, System::Runtime::InteropServices::ComTypes::IMoniker ^ pmkObjectName);

public int Register (int grfFlags, object punkObject, System.Runtime.InteropServices.ComTypes.IMoniker pmkObjectName);

abstract member Register : int * obj * System.Runtime.InteropServices.ComTypes.IMoniker -> int

Public Function Register (grfFlags As Integer, punkObject As Object, pmkObjectName As IMoniker) As Integer

Parameters

grfFlags: Int32

Specifies whether the Running Object Table's (ROT) reference to punkObject is weak or strong, and controls access to the object through its entry in the ROT.

punkObject: Object

A reference to the object being registered as running.

pmkObjectName: IMoniker

A reference to the moniker that identifies punkObject.

Returns

Int32

A value that can be used to identify this ROT entry in subsequent calls to Revoke(Int32) or NoteChangeTime(Int32, FILETIME).

Remarks

ROT references to punkObject (weak and strong) determine object lifetime. For more information, see IRunningObjectTable::Register method.

Applies to