IOleObject::GetUserClassID

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method returns the object class identifier (CLSID) corresponding to the string identifying the object to an user.

Syntax

HRESULT GetUserClassID( 
  CLSID* pClsid
);

Parameters

  • pClsid
    [out] 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 supports the standard return value E_FAIL, as well as S_OK, which indicates that the CLSID returned successfully.

Remarks

GetUserClassID returns the CLSID associated with the object in the registration database. Usually, 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 is that of the class being emulated rather than that of the object's own class.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header Oleidl.h, oleidl.idl
Library oleaut32.lib, uuid.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IOleObject
IOleObject::GetUserType
IPersist::GetClassID

Concepts

Determining Supported COM APIs