QDBusConnectionInterface Class

Documentation des fonctions membres

[signal] void QDBusConnectionInterface::callWithCallbackFailed(const QDBusError &error, const QDBusMessage &call)

Ce signal est émis lorsqu'une erreur survient lors d'un appel à la fonction ` QDBusConnection::callWithCallback()`. ` error ` précise la nature de l'erreur. ` call ` correspond au message qui n'a pas pu être transmis.

Voir également QDBusConnection::callWithCallback().

[slot] QDBusReply<bool> QDBusConnectionInterface::isServiceRegistered(const QString &serviceName) const

Renvoie « true » si le nom de service « serviceName » est actuellement enregistré.

[slot] QDBusReply<QDBusConnectionInterface::RegisterServiceReply> QDBusConnectionInterface::registerService(const QString &serviceName, QDBusConnectionInterface::ServiceQueueOptions qoption = DontQueueService, QDBusConnectionInterface::ServiceReplacementOptions roption = DontAllowReplacement)

Demande l'enregistrement du nom de service serviceName sur le bus. Le drapeau qoption spécifie comment le serveur D-Bus doit se comporter si serviceName est déjà enregistré. Le drapeau roption spécifie si le serveur doit autoriser une autre application à remplacer notre nom enregistré.

Si l'enregistrement du service aboutit, le signal serviceRegistered() sera émis. Si nous sommes placés en file d'attente, le signal sera émis lorsque nous obtiendrons le nom. Si roption correspond à AllowReplacement, le signal serviceUnregistered() sera émis si une autre application remplace celle-ci.

Voir également unregisterService().

[slot, since 6.10] QDBusReply<QVariantMap> QDBusConnectionInterface::serviceCredentials(const QString &serviceName) const

Renvoie les informations d'serviceName de connexion du processus qui détient actuellement le service de bus.

Pour plus d'informations, consultez la section <https://dbus.freedesktop.org/doc/dbus-specification.html> : « Méthode : org.freedesktop.DBus.GetConnectionCredentials ».

Cette fonction a été introduite dans Qt 6.10.

[slot] QDBusReply<QString> QDBusConnectionInterface::serviceOwner(const QString &name) const

Renvoie le nom de connexion unique du propriétaire principal du nom name. Si le nom demandé n'a pas de propriétaire, renvoie une erreur « org.freedesktop.DBus.Error.NameHasNoOwner ».

[slot] QDBusReply<uint> QDBusConnectionInterface::servicePid(const QString &serviceName) const

Renvoie l'identifiant de processus Unix (PID) du processus qui gère actuellement le service de bus serviceName.

[signal] void QDBusConnectionInterface::serviceRegistered(const QString &service)

Ce signal est émis par le serveur D-Bus lorsque le nom du service du bus (nom de connexion unique ou nom de service bien connu) fourni par la fonction ` service ` est acquis par cette application.

L'acquisition a lieu après que cette application a demandé un nom à l'aide de la fonction registerService().

[slot] QDBusReply<uint> QDBusConnectionInterface::serviceUid(const QString &serviceName) const

Renvoie l'identifiant utilisateur Unix (UID) du processus qui détient actuellement le service de bus serviceName.

[signal] void QDBusConnectionInterface::serviceUnregistered(const QString &service)

Ce signal est émis par le serveur D-Bus lorsque cette application perd la propriété du nom de service du bus fourni par service.

[slot] QDBusReply<void> QDBusConnectionInterface::startService(const QString &name)

Demande au bus de lancer le service portant le nom « name ».

[slot] QDBusReply<bool> QDBusConnectionInterface::unregisterService(const QString &serviceName)

Libère la revendication du nom de service de bus « serviceName », qui avait été préalablement enregistré auprès de registerService(). Si cette application détenait la propriété du nom, celui-ci sera libéré et d'autres applications pourront le revendiquer. Si elle n'avait fait que mettre le nom en file d'attente, elle abandonne alors sa place dans la file d'attente.