next up previous contents index
Next: 4.9.4 oskit_lookup_first: Obtain the Up: 4.9 Services Registry Previous: 4.9.2 oskit_unregister: Unregister a

4.9.3 oskit_lookup: Obtain a list of all COM interfaces registered for an IID

 

SYNOPSIS

#include <oskit/com/services.h>

oskit_error_t oskit_lookup(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. By default, the first interface registered is the first interface placed in the array.

PARAMETERS

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.



University of Utah Flux Research Group