InstallerHandle Class

Microsoft Deployment Tools

Deployment Tools Foundation InstallerHandle Class
Deployment Tools Foundation NamespacesMicrosoft.Deployment.WindowsInstallerInstallerHandle
Base class for Windows Installer handle types (Database, View, Record, SummaryInfo).
Declaration Syntax
C# Visual Basic Visual C++
public abstract class InstallerHandle : MarshalByRefObject, IDisposable
Public MustInherit Class InstallerHandle _
	Inherits MarshalByRefObject _
	Implements IDisposable
public ref class InstallerHandle abstract : public MarshalByRefObject, 
	IDisposable
Members
All Members Constructors Methods Properties



Icon Member Description
InstallerHandle(IntPtr, Boolean)
Constructs a handle object from a native integer handle.

Close()()()
Closes the handle. After closing a handle, further method calls may throw an InvalidHandleException.

CreateObjRef(Type)
Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.
(Inherited from MarshalByRefObject.)
Dispose()()()
Closes the handle. After closing a handle, further method calls may throw an InvalidHandleException.

Dispose(Boolean)
Closes the handle. After closing a handle, further method calls may throw an InvalidHandleException.

Equals(Object)
Tests whether this handle object is equal to another handle object. Two handle objects are equal if their types are the same and their native integer handles are the same.
(Overrides Object.Equals(Object).)
Finalize()()()
Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.
(Inherited from Object.)
GetHashCode()()()
Gets a hash value for the handle object.
(Overrides Object.GetHashCode()()().)
GetLifetimeService()()()
Retrieves the current lifetime service object that controls the lifetime policy for this instance.
(Inherited from MarshalByRefObject.)
GetType()()()
Gets the Type of the current instance.
(Inherited from Object.)
Handle
Gets the native integer handle.

InitializeLifetimeService()()()
Obtains a lifetime service object to control the lifetime policy for this instance.
(Inherited from MarshalByRefObject.)
IsClosed
Checks if the handle is closed. When closed, method calls on the handle object may throw an InvalidHandleException.

MemberwiseClone(Boolean)
Creates a shallow copy of the current MarshalByRefObject object.
(Inherited from MarshalByRefObject.)
MemberwiseClone()()()
Creates a shallow copy of the current Object.
(Inherited from Object.)
ToString()()()
Returns a String that represents the current Object.
(Inherited from Object.)
Remarks

These classes implement the IDisposable interface, because they hold unmanaged resources (MSI handles) that should be properly disposed when no longer needed.

Inheritance Hierarchy
Object
MarshalByRefObject
  InstallerHandle
    Database
    Transaction
    Record
    Session
    SummaryInfo
    View

Assembly: Microsoft.Deployment.WindowsInstaller (Module: Microsoft.Deployment.WindowsInstaller) Version: 3.0.0.0 (3.5.1623.0)