COMStringFromGUID

DFCOM Subroutine: Passes a globally unique identifier (GUID) and returns a string of printable characters.

Modules: USE DFCOM, USE DFWINTY

Syntax

CALL COMStringFromGUID (guid, string, status)

guid
The GUID to be converted. Must be of type GUID, which is defined in the DFWINTY module. It can be any type of GUID, including a class identifier (CLSID), or an interface identifier (IID).

string
A character variable of type CHARACTER*(*) that receives the string representation of the GUID. The length of the character variable should be at least 38.

status
The status of the operation. If the string is too small to contain the string representation of the GUID, the value is zero. Otherwise, the value is the number of characters in the string representation of the GUID. Must be of type INTEGER(4).

The string representation of a GUID has a format like that of the following:

[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:

StringFromGUID2 in the Win32 SDK