StringFromIID

Converts an interface identifier into a string of printable characters.

WINOLEAPI StringFromIID(
  REFIID rclsid,     //Interface identifier to be converted
  LPOLESTR * lplpsz  //Address of output variable that receives a 
                     // pointer to the resulting string
);
 

Parameters

rclsid
[in] Interface identifier to be converted.
lplpsz
[out] Address of LPOLESTR pointer variable that receives a pointer to the resulting string.

Return Values

This function supports the standard return value E_OUTOFMEMORY; as well as the following:

S_OK
The character string was successfully returned.

Remarks

The string returned by the function is freed in the standard way, using the task allocator (refer to the CoGetMallocfunction).

Windows CE: Passing into this function any invalid and, under some circumstances, NULL pointers will result in unexpected termination of the application. For more information about handling exceptions, see Programming Considerations.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Use version 2.0 or later.
  Header: Declared in objbase.h.
  Import Library: Included as a resource in ole32.dll.

See Also

IIDFromString, CoGetMalloc