next up previous contents index
Next: 5.1.4 lookup_first: Obtain the Up: 5.1 oskit_services: registration database Previous: 5.1.2 remservice: Unregister a

5.1.3 lookup: Obtain a list of all COM interfaces registered for an IID

 

SYNOPSIS

#include <oskit/com/services.h>

OSKIT_COMDECL oskit_services_lookup(oskit_services_t *s, const struct oskit_guid *iid, [out] void ***out_interface_array);

DESCRIPTION

Look up the set of interfaces that have been registered with a particular IID, returning an array of COM interfaces. The client is responsible for releasing the references on the interfaces, and deallocating the array (with free). By default, the first interface registered is the first interface placed in the array.

PARAMETERS

s
The services registry object.
iid
The oskit_guid of the COM interface being looked up..
out_interface_array
The array of COM interfaces registered for the given IID.

RETURNS

Returns the number of COM interfaces found, or 0 if there were no matches.



Utah Flux Research Group