CLSIDFromProgID function (COM)

Switch View :
ScriptFree
CLSIDFromProgID function

Applies to: desktop apps only

Looks up a CLSID in the registry, given a ProgID.

Syntax

HRESULT CLSIDFromProgID(
  __in   LPCOLESTR lpszProgID,
  __out  LPCLSID lpclsid
);

Parameters

lpszProgID [in]

A pointer to the ProgID whose CLSID is requested.

lpclsid [out]

Receives a pointer to the retrieved CLSID on return.

Return value

This function can return the following values.

Return codeDescription
S_OK

The CLSID was retrieved successfully.

CO_E_CLASSSTRING

The registered CLSID for the ProgID is invalid.

REGDB_E_WRITEREGDB

An error occurred writing the CLSID to the registry. See Remarks below.

 

Remarks

Given a ProgID, CLSIDFromProgID looks up its associated CLSID in the registry. If the ProgID cannot be found in the registry, CLSIDFromProgID creates an OLE 1 CLSID for the ProgID and a CLSID entry in the registry. Because of the restrictions placed on OLE 1 CLSID values, CLSIDFromProgID and CLSIDFromString are the only two functions that can be used to generate a CLSID for an OLE 1 object.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Objbase.h

Library

Ole32.lib

DLL

Ole32.dll

See also

CLSIDFromProgIDEx
ProgIDFromCLSID

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Community Content

ghsw
Example
CLSID clsid;                      // Class ID of Hello object.
HRESULT hr = CLSIDFromProgID("Hello.Application", &clsid);

More at http://msdn.microsoft.com/en-us/library/ms221577.aspx.