make-guid-from-string

make-guid-from-string Function

Summary

Make a refguid object from a hex string.

Package

com

Signature

make-guid-from-string string &optional interface-name => refguid

Arguments

`string`⇩	A string in the standard hex format for GUIDs.
`interface-name`⇩	A symbol naming a COM interface. If non-nil, `refguid` will be will added to the table of known refguids.

Values

refguid

A refguid object matching string.

Description

The function make-guid-from-string makes a refguid object from string. If the GUID data matches a known refguid, then that is returned. Otherwise, a new refguid is created and returned. If interface-name is non-nil, then the table of known refguids is updated. If the GUID is already known under a different name, an error is signaled.

Examples

This GUID is a predefined one for i-unknown:

(refguid-interface-name
 (make-guid-from-string
  "00000000-0000-0000-C000-000000000046"))
=> I-UNKNOWN