StringFromGUID2
This function converts a globally unique identifier (GUID) into a string of printable characters.
StringFromGUID2(
REFGUID rguid,
LPOLESTR lpsz,
int cbMax);
Parameters
- rguid
[in] Interface identifier to be converted. - lpsz
[out] Long pointer to the resulting null-terminated string on return. - cbMax
[in] Character count of the string indicated by lpsz.
Return Values
Nonzero indicates the number of characters in the returned string, including the terminating null character. Zero indicates that the buffer is too small for returned string.
Remarks
The string that the lpsz parameter receives has a format like that of 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.
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.
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.