gobj_find_service_by_gclass()

gobj_find_service_by_gclass()#

Finds a service gobj by its gclass name. Returns a handle to the first matching service or NULL if not found.

Prototype

hgobj gobj_find_service_by_gclass(
    const char *gclass_name,
    BOOL verbose
);

Parameters

Key

Type

Description

gclass_name

const char *

The name of the gclass to search for.

verbose

BOOL

If TRUE, logs an error message when the service is not found.


Return Value

Returns a handle to the first service gobj matching the given gclass name, or NULL if no match is found.

Notes

If verbose is set to TRUE and no matching service is found, an error message is logged.

Prototype

// Not applicable in JS

Prototype

# Not applicable in Python
Examples
// TODO C examples
// TODO JS examples
# TODO Python examples