Function

Summary

The release function decrements the reference count of an interface pointer.

Package

com

Signature

release interface-ptr => ref-count

Arguments

interface-ptr

A COM interface pointer.

Values

ref-count

The new reference count.

Description

Each COM interface pointer has a reference count which is used by the server to control its lifetime. The function release should be called whenever a reference to the interface pointer is being removed. The function invokes the COM method IUnknown::Release so the form (release ptr) is equivalent to using call-com-interface as follows:

(call-com-interface (ptr i-unknown release))

Example

(release p-foo)

See also

add-ref
interface-ref
query-interface
with-temp-interface