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

5.1.1 addservice: Register an interface in the services registry

 

SYNOPSIS

#include <oskit/com/services.h>

OSKIT_COMDECL oskit_services_addservice(oskit_services_t *s, const struct oskit_guid *iid, void *interface);

DESCRIPTION

Register a COM interface in the services registry. An additional reference on the interface is taken. More than one interface may be registered for a particular IID. Attempts to register an interface that is already registered will succeed, although the registry will remain unchanged and no additional references will be taken.

PARAMETERS

s
The services registry object.
iid
The oskit_guid of the COM interface being registered.
interface
The COM interface being registered.

RETURNS

Returns 0 on success, or an error code specified in <oskit/error.h>, on error.



Utah Flux Research Group