GUPnPServiceInfo

GUPnPServiceInfo — Base abstract class for querying service information.

Synopsis




                    GUPnPServiceInfo;
void                (*GUPnPServiceIntrospectionCallback)
                                                        (GUPnPServiceInfo *info,
                                                         GUPnPServiceIntrospection *introspection,
                                                         const GError *error,
                                                         gpointer user_data);
GUPnPContext*       gupnp_service_info_get_context      (GUPnPServiceInfo *info);
const char*         gupnp_service_info_get_location     (GUPnPServiceInfo *info);
const SoupUri*      gupnp_service_info_get_url_base     (GUPnPServiceInfo *info);
const char*         gupnp_service_info_get_udn          (GUPnPServiceInfo *info);
const char*         gupnp_service_info_get_service_type (GUPnPServiceInfo *info);
char*               gupnp_service_info_get_id           (GUPnPServiceInfo *info);
char*               gupnp_service_info_get_scpd_url     (GUPnPServiceInfo *info);
char*               gupnp_service_info_get_control_url  (GUPnPServiceInfo *info);
char*               gupnp_service_info_get_event_subscription_url
                                                        (GUPnPServiceInfo *info);
GUPnPServiceIntrospection* gupnp_service_info_get_introspection
                                                        (GUPnPServiceInfo *info,
                                                         GError **error);
void                gupnp_service_info_get_introspection_async
                                                        (GUPnPServiceInfo *info,
                                                         GUPnPServiceIntrospectionCallback callback,
                                                         gpointer user_data);


Description

The GUPnPDeviceInfo base abstract class provides methods for querying service information.

Details

GUPnPServiceInfo

typedef struct {
        GObject parent;

        GUPnPServiceInfoPrivate *priv;
} GUPnPServiceInfo;


GUPnPServiceIntrospectionCallback ()

void                (*GUPnPServiceIntrospectionCallback)
                                                        (GUPnPServiceInfo *info,
                                                         GUPnPServiceIntrospection *introspection,
                                                         const GError *error,
                                                         gpointer user_data);

info : The GUPnPServiceInfo introspection was requested for
introspection : The new GUPnPServiceIntrospection object, or NULL
error : The GError that occurred, or NULL
user_data : User data

gupnp_service_info_get_context ()

GUPnPContext*       gupnp_service_info_get_context      (GUPnPServiceInfo *info);

info : A GUPnPServiceInfo
Returns : The GUPnPContext associated with info.

gupnp_service_info_get_location ()

const char*         gupnp_service_info_get_location     (GUPnPServiceInfo *info);

info : A GUPnPServiceInfo
Returns : The location of the device description file.

gupnp_service_info_get_url_base ()

const SoupUri*      gupnp_service_info_get_url_base     (GUPnPServiceInfo *info);

info : A GUPnPServiceInfo
Returns : The URL base.

gupnp_service_info_get_udn ()

const char*         gupnp_service_info_get_udn          (GUPnPServiceInfo *info);

info : A GUPnPServiceInfo
Returns : The UDN of the containing device.

gupnp_service_info_get_service_type ()

const char*         gupnp_service_info_get_service_type (GUPnPServiceInfo *info);

info : A GUPnPServiceInfo
Returns : The UPnP service type, or NULL.

gupnp_service_info_get_id ()

char*               gupnp_service_info_get_id           (GUPnPServiceInfo *info);

info : A GUPnPServiceInfo
Returns : The ID, or NULL. g_free() after use.

gupnp_service_info_get_scpd_url ()

char*               gupnp_service_info_get_scpd_url     (GUPnPServiceInfo *info);

info : A GUPnPServiceInfo
Returns : The SCPD URL, or NULL. g_free() after use.

gupnp_service_info_get_control_url ()

char*               gupnp_service_info_get_control_url  (GUPnPServiceInfo *info);

info : A GUPnPServiceInfo
Returns : The control URL, or NULL. g_free() after use.

gupnp_service_info_get_event_subscription_url ()

char*               gupnp_service_info_get_event_subscription_url
                                                        (GUPnPServiceInfo *info);

info : A GUPnPServiceInfo
Returns : The event subscription URL, or NULL. g_free() after use.

gupnp_service_info_get_introspection ()

GUPnPServiceIntrospection* gupnp_service_info_get_introspection
                                                        (GUPnPServiceInfo *info,
                                                         GError **error);

Note that introspection object is created from the information in service description document (SCPD) provided by the service so it can not be created if the service does not provide an SCPD.

info : A GUPnPServiceInfo
error : return location for a GError, or NULL
Returns : A new GUPnPServiceIntrospection for this service or NULL. Unref after use.

gupnp_service_info_get_introspection_async ()

void                gupnp_service_info_get_introspection_async
                                                        (GUPnPServiceInfo *info,
                                                         GUPnPServiceIntrospectionCallback callback,
                                                         gpointer user_data);

Note that introspection object is created from the information in service description document (SCPD) provided by the service so it can not be created if the service does not provide an SCPD.

info : A GUPnPServiceInfo
callback : callback to be called when introspection object is ready.
user_data : user_data to be passed to the callback.