# COMStringFromGUID (W*S)

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

## Module

USE IFCOM

USE IFWINTY

CALL COMStringFromGUID (guid,string,status)

guid | The GUID to be converted. Must be of type GUID, which is defined in the IFWINTY 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.

Parent topic: Automation Server (AUTO) and Component Object Model (COM) Library Routines