find-component-tlb

Function

Summary

Returns the path of the type library associated with a component name.

Package

com

Signature

find-component-tlb
name
&key
version
min-version
max-version
=>
path

Arguments

name

A string.

version

A string or
nil
.

min-version

A string or
nil
.

max-version

A string or
nil
.

Values

path

A string or
nil
.

Description

The function
find-component-tlb
returns the path of the type library associated with the component
name
.

name
should be the name of a component (either a ProgID or a GUID).

If
version
is supplied,
find-component-tlb
finds only this version of the type library.

If
min-version
or
max-version
, or both of these, are supplied, they restrict which version of the type library can be found.

Each of
version
,
min-version
and
max-version
, if supplied, should be a string. The string should contain either one hexadecimal number or two hexadecimal numbers separated by a dot. The first number is the major version, the second is the minor version, which defaults to 0.

If
version
is not supplied, then
find-component-tlb
preferentially finds the the library version specified in the registry for the component (if any) if it fits the specification by
max-version
and/or
min-version
, otherwise it finds the earliest version in the range specified by
min-version
and
max-version
.

find-component-tlb
returns
nil
if it fails to find the type library within the specified version constraints.