StringFromGUID2

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

int StringFromGUID2(

REFGUID rguid,	//The interface ID to be converted
LPOLESTR lpsz,	//Receives the resulting string on return
int cbMax	//The maximum size the returned string is expected to be
);

Parameters
rguid

Specifies the interface ID to be converted.

lpsz

Receives the resulting string on return.

cbMax

Specifies the maximum size the returned string is expected to be.

Return Values
0 (zero)

Indicates buffer is too small for returned string.

Non-zero value

Specifies the number of characters in the returned string, including the null terminator.

Comments
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.