IOleObject::GetUserClassID method (oleidl.h)

Retrieves an object's class identifier, the CLSID corresponding to the string identifying the object to an end user.

Syntax

HRESULT GetUserClassID(
  [out] CLSID *pClsid
);

Parameters

[out] pClsid

Pointer to the class identifier (CLSID) to be returned. An object's CLSID is the binary equivalent of the user-type name returned by IOleObject::GetUserType.

Return value

This method returns S_OK on success. Other possible return values include the following.

Return code Description
E_FAIL
The operation failed.

Remarks

IOleObject::GetUserClassID returns the CLSID associated with the object in the registration database. Normally, this value is identical to the CLSID stored with the object, which is returned by IPersist::GetClassID. For linked objects, this is the CLSID of the last bound link source. If the object is running in an application different from the one in which it was created and for the purpose of being edited is emulating a class that the container application recognizes, the CLSID returned will be that of the class being emulated rather than that of the object's own class.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header oleidl.h

See also

GetConvertStg

IOleObject

IOleObject::GetUserType

IPersist::GetClassID

OleDoAutoConvert

OleSetAutoConvert

SetConvertStg