CLSIDFromProgID function

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

Syntax

HRESULT CLSIDFromProgID(
  LPCOLESTR lpszProgID,
  LPCLSID   lpclsid
);

Parameters

lpszProgID

A pointer to the ProgID whose CLSID is requested.

lpclsid

Receives a pointer to the retrieved CLSID on return.

Return Value

This function can return the following values.

Return code Description
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 [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header combaseapi.h (include Objbase.h)
Library Ole32.lib
DLL Ole32.dll

See Also

CLSIDFromProgIDEx

ProgIDFromCLSID