Method
PeasEnginecreate_extension_with_properties
since: 1.24
Declaration [src]
PeasExtension*
peas_engine_create_extension_with_properties (
PeasEngine* engine,
PeasPluginInfo* info,
GType extension_type,
guint n_properties,
const gchar** prop_names,
const GValue* prop_values
)
Description [src]
If the plugin identified by info
implements the extension_type
,
then this function will return a new instance of this implementation,
wrapped in a new PeasExtension
instance. Otherwise, it will return NULL
.
Since libpeas 1.22, extension_type
can be an Abstract GType
and not just an Interface GType
.
See peas_engine_create_extension()
for more information.
Available since: 1.24
This method is renamed to peas_engine_create_extension()
in language bindings.
Parameters
info
-
Type:
PeasPluginInfo
A loaded
PeasPluginInfo
.The data is owned by the caller of the method. extension_type
-
Type:
GType
The implemented extension
GType
. n_properties
-
Type:
guint
The length of the
prop_names
andprop_values
array. prop_names
-
Type: An array of
gchar*
An array of property names.
The length of the array is specified in the n_properties
argument.The data is owned by the caller of the method. Each element is a NUL terminated UTF-8 string. prop_values
-
Type: An array of
GValue
An array of property values.
The length of the array is specified in the n_properties
argument.The data is owned by the caller of the method.
Return value
Type: PeasExtension
A new instance of PeasExtension
wrapping the extension_type
instance, or NULL
.
The caller of the method takes ownership of the returned data, and is responsible for freeing it. |