Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

COMStringFromGUID

COM Subroutine: Passes a globally unique identifier (GUID) and returns a string of printable characters. This routine is only available for Windows.

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.