Share via


StringFromCLSID

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function converts a class identifier into a string of printable characters. Different class identifiers always convert to different strings.

Syntax

WINOLEAPI StringFromCLSID(
  REFCLSID rclsid, 
  LPOLESTR* ppsz
); 

Parameters

  • rclsid
    [in] Class identifier to be converted.
  • ppsz
    [out] Address of LPOLESTR pointer variable that receives a pointer to the resulting null-terminated string.

Return Value

S_OK indicates that the class identifier was successfully converted and returned. The standard return value E_OUTOFMEMORY is also supported.

Remarks

The StringFromCLSID function calls the StringFromGUID2 function to convert a globally unique identifier (GUID) into a string of printable characters.

The caller is responsible for freeing the memory allocated for the string by calling CoTaskMemFree.

Passing into this function any invalid and, under some circumstances, NULL pointers results in unexpected termination of the application.

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

Requirements

Header objbase.h
Library ole32.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

CoTaskMemFree
StringFromGUID2