CLSID$ function

Purpose

Return a 16-byte GUID string (128-bit GUID format string) containing a CLSID associated with a unique ProgramID string of a COM object or component.

Syntax

a$ = CLSID$(ProgramID$)

Remarks

A CLSID string is a 128-bit (16-byte) binary string representing the GUID or UUID of a COM object/component.  A CLSID string is not in a human-readable format.

You can convert textual ID name of a COM object/component into a CLSID string with the CLSID$ function.  CLSID examines the system registry in order to determine the CLSID string associated with the ProgramID$ string.

The ProgramID$ parameter is not case-sensitive, so "MSAGENT.CONTROL.2", "MSAgent.Control.2" and "msagent.control.2" all refer to the same COM object/component.  If the ProgramID$ cannot be found, or if any error occurs during the lookup and conversion process, CLSID$ will not set the ERR system variable, but will return an empty string.

To convert the binary CLSID string into human-readable GUID/UUID format, use the GUIDTXT$ function.  CLSID$ is the complement to the PROGID$ function.

PowerBASIC programmers rarely, if ever, need to deal with CLSID strings in order to utilize a COM object or component.               

a$

The return string may be assigned to a dynamic string, fixed-length or nul-terminated string (at least 16 bytes long), or (typically) a GUID variable.  See DIM for more information.

See also

DIM, GUID$, GUIDTXT$, INTERFACE (Direct), INTERFACE (IDBind), ISNOTHING, ISOBJECT, LET (with Objects), OBJECT, OBJACTIVE, OBJPTR, OBJRESULT, PROGID$, What does a Class look like?, What is an object, anyway?

Example

MSWordClassID$ = CLSID$("word.application.8")

IF LEN(MSWordClassID$) = 16 THEN

  ' Success getting the CLSID$ of MSWord

  a$ = PROGID$(MSWordClassID$)

  'a$ holds "Word.Application.8"

  b$ = GUIDTXT$(MSWordClassID$)

  'b$ holds "{000209FF-0000-0000-C000-000000000046}"

END IF