# StringFromGUID2

Converts a globally unique identifier (GUID) into a string of printable characters.

StringFromGUID2(

REFGUID rguid, | //Interface identifier to be converted
LPOLESTR lpsz, | //Pointer to the resulting string on return
int cbMax | //Maximum size the returned string is expected to be
); |

Parameters

rguid
  [in] Interface identifier to be converted.
lpsz
  [out] Pointer to the resulting string on return.
cbMax
  [in] Maximum size the returned string is expected to be.

Return Values

0 (zero)
  Buffer is too small for returned string.
Non-zero value
  The number of characters in the returned string, including the null terminator.

Remarks

The string that the lpsz parameter receives has a format like the following sample:

    [c200e360-38c5-11ce-ae62-08002b2b79ef]

where the successive fields break the GUID into the form DWORD-WORD-WORD-WORD-WORD.DWORD covering the 128-bit GUID. The string includes enclosing braces, which are an OLE convention.

See Also

StringFromCLSID