This documentation is archived and is not being maintained.

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.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

static Type^ GetTypeFromCLSID(
	Guid clsid, 
	bool throwOnError


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 Value

Type: System::Type
System.__ComObject regardless of whether the CLSID is valid.

Exceptions such as OutOfMemoryException will be thrown when specifying true for throwOnError, but it will not fail for unregistered CLSIDs.

The following example retrieves the type associated with the CLSID from the local host, specifying whether to throw an exception if an error occurs while loading the type.

using namespace System;

int main()
      // Create a GUID.
      Guid myGuid1 = Guid("1DCD0710-0B41-11D3-A565-00C04F8EF6E3");
      // Get the type associated with the CLSID 
      // and specify whether to throw an exception if an error occurs 
      // while loading the type.
      Type^ myType1 = Type::GetTypeFromCLSID( myGuid1, true );
      Console::WriteLine( "The GUID associated with myType1 is {0}.", myType1->GUID );
      Console::WriteLine( "The type of the GUID is {0}.", myType1 );

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0