 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function converts a class identifier into a string of printable characters. Different class identifiers always convert to different strings.
WINOLEAPI StringFromCLSID( REFCLSID rclsid, LPOLESTR * ppsz );
Parameters
- rclsid
- [in] Class identifier to be converted.
- ppsz
- [out] Address of
LPOLESTRpointer variable that receives a pointer to the
resulting null-terminated string.
Return Values
S_OK indicates the class identifier was successfully converted and returned. The standard return value E_OUTOFMEMORY is also supported.
Remarks
The StringFromCLSIDfunction calls the StringFromGuid2function 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 result in unexpected termination of the application.
Requirements
Runs On Versions Defined in Include Link to Windows CE OS 2.0 and later Objbase.h Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
CoTaskMemFree, StringFromGuid2