Type::GetTypeFromCLSID Method (Guid, Boolean)
Gets the type associated with the specified class identifier (CLSID), specifying whether to throw an exception if an error occurs while loading the type.
Assembly: mscorlib (in mscorlib.dll)
- Type: System::Guid
The CLSID of the type to get.
- Type: System::Boolean
true to throw any exception that occurs.
false to ignore any exception that occurs.
Return ValueType: System::Type
System.__ComObject regardless of whether the CLSID is valid.
The GetTypeFromCLSID method supports late-bound access to COM objects from .NET Framework apps when you know the object's class identifier (CLSID). The class identifier for COM classes is defined in the HKEY_CLASSES_ROOT\CLSID key of the registry. You can retrieve the value of the IsCOMObject property to determine whether the type returned by this method is a COM object.
You can call the GetTypeFromProgID method for late-bound access to COM objects whose programmatic identifier (ProgID) you know.
Instantiating a COM object from its CLSID is a two-step process:
Call the Activator::CreateInstance(Type) method to instantiate the COM object.
See the example for an illustration.
Exceptions such as OutOfMemoryException will be thrown when specifying true for throwOnError, but it will not fail for unregistered CLSIDs.Notes to Callers
This method is intended for use when working with COM objects, not with .NET Framework objects. Although the method returns a Type object that corresponds to the GUID for .NET Framework objects, you can't use that Type object to create a type instance by calling the Activator::CreateInstance method, as the following example shows.
The following example uses the CLSID of the Microsoft Word Application object to retrieve a COM type that represents the Microsoft Word application. It then instantiates the type by calling the Activator::CreateInstance method, and closes it by calling the Application.Quit method. An exception is thrown if an error occurs while loading the type.
Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.