StringFromGUID2.md

Home

Function name : StringFromGUID2

Group: COM - Library: ole32

---

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

---

Code examples:

Winsock: retrieving information about available transport protocols
Custom GDI+ class
How to generate GUID values
Smart Card Database Query Functions
Enumerating devices installed on the local machine

Declaration:

int StringFromGUID2(
  REFGUID rguid,
  LPOLESTR lpsz,
  int cchMax
);  

---

FoxPro declaration:

DECLARE INTEGER StringFromGUID2 IN ole32;
	STRING    rguid,;
	STRING  @ lpsz,;
	INTEGER   cchMax
  

---

Parameters:

rguid [in] GUID to be converted.

lpsz [out] Pointer to a caller-allocated string variable to contain the resulting string on return.

cchMax [in] Number of characters available in the buffer indicated by lpsz.

---

Return value:

The number of characters in the returned string, including the null terminator or zero if the array at lpsz is too small to contain a string representation of a GUID.

---

Comments:

The string that the lpsz parameter receives has a format like that of the following sample:
{557cf400-1a04-11d3-9a73-0000f81ef32e}

See also: CLSIDFromString.

---