# QDBusConnectionInterface Class Reference ## [[QtDBus](index.htm) module] 該QDBusConnectionInterface類提供??訪問D - Bus總線守護進程服務。[More...](#details) 繼承[QDBusAbstractInterface](qdbusabstractinterface.html)。 ### Types * `enum RegisterServiceReply { ServiceNotRegistered, ServiceRegistered, ServiceQueued }` * `enum ServiceQueueOptions { DontQueueService, QueueService, ReplaceExistingService }` * `enum ServiceReplacementOptions { DontAllowReplacement, AllowReplacement }` ### Methods * `connectNotify (self, SIGNAL())` * `disconnectNotify (self, SIGNAL())` * `QDBusReply isServiceRegistered (self, QString?serviceName)` * `QDBusReply registeredServiceNames (self)` * `QDBusReply registerService (self, QString?serviceName, ServiceQueueOptions?qoption?=?QDBusConnectionInterface.DontQueueService, ServiceReplacementOptions?roption?=?QDBusConnectionInterface.DontAllowReplacement)` * `QDBusReply serviceOwner (self, QString?name)` * `QDBusReply servicePid (self, QString?serviceName)` * `QDBusReply serviceUid (self, QString?serviceName)` * `QDBusReply startService (self, QString?name)` * `QDBusReply unregisterService (self, QString?serviceName)` ### Qt Signals * `void callWithCallbackFailed (const QDBusError&,const QDBusMessage&)` * `void serviceOwnerChanged (const QString&,const QString&,const QString&)` * `void serviceRegistered (const QString&)` * `void serviceUnregistered (const QString&)` * * * ## Detailed Description 該QDBusConnectionInterface類提供??訪問D - Bus總線守護進程服務。 在D - Bus總線服務器守護進程提供1個專用接口`org.freedesktop.DBus`允許客戶端訪問總線的某些屬性，如連接的客戶端的列表。該QDBusConnectionInterface類提供了訪問該界面。 這個類最常見的用途是用在總線上注冊和注銷服務名稱[registerService](qdbusconnectioninterface.html#registerService)（）和[unregisterService](qdbusconnectioninterface.html#unregisterService)采用（ ）函數，查詢有關現有名稱[isServiceRegistered](qdbusconnectioninterface.html#isServiceRegistered)（ ）[registeredServiceNames](qdbusconnectioninterface.html#registeredServiceNames-prop)（）和[serviceOwner](qdbusconnectioninterface.html#serviceOwner)（ ）函數，并接收客戶端已通過注冊或取消注冊的通知[serviceRegistered](qdbusconnectioninterface.html#serviceRegistered)（ ）[serviceUnregistered](qdbusconnectioninterface.html#serviceUnregistered)（）和[serviceOwnerChanged](qdbusconnectioninterface.html#serviceOwnerChanged)（ ）信號。 * * * ## Type Documentation ``` QDBusConnectionInterface.RegisterServiceReply ``` 從可能的返回值[registerService](qdbusconnectioninterface.html#registerService)（）： | Constant | Value | Description | | --- | --- | --- | | `QDBusConnectionInterface.ServiceNotRegistered` | `0` | 該呼叫失敗和服務名稱未注冊。 | | `QDBusConnectionInterface.ServiceRegistered` | `1` | 呼叫者現在是服務名稱的擁有者。 | | `QDBusConnectionInterface.ServiceQueued` | `2` | 調用者指定的[QueueService](qdbusconnectioninterface.html#ServiceQueueOptions-enum)標志和服務已經注冊，所以我們在隊列中。 | 該[serviceRegistered](qdbusconnectioninterface.html#serviceRegistered)當由該應用程序獲得的服務（）信號將被發射。 ``` QDBusConnectionInterface.ServiceQueueOptions ``` 標志確定一個服務注冊應該如何表現，如果服務名已被注冊。 | Constant | Value | Description | | --- | --- | --- | | `QDBusConnectionInterface.DontQueueService` | `0` | 如果一個應用程序請求一個已經擁有一個名字，沒有排隊會被執行。該registeredService （ ）調用只會失敗。這是默認的。 | | `QDBusConnectionInterface.QueueService` | `1` | 嘗試注冊??請求的服務，但不要試圖取代它，如果另一個應用程序已經有它注冊。相反，只要把這個應用程序在隊列中，直到它被放棄。該[serviceRegistered](qdbusconnectioninterface.html#serviceRegistered)當發生這種情況（在）信號將被發射。 | | `QDBusConnectionInterface.ReplaceExistingService` | `2` | 如果另一個應用程序已經有注冊的服務名，試圖取代它。 | **See also** [ServiceReplacementOptions](qdbusconnectioninterface.html#ServiceReplacementOptions-enum)。 ``` QDBusConnectionInterface.ServiceReplacementOptions ``` 標志確定，如果D- Bus服務器應該允許其他應用程序來替換一個名字，這個應用程序已經注冊了[ReplaceExistingService](qdbusconnectioninterface.html#ServiceQueueOptions-enum)選項。 可能的值有： | Constant | Value | Description | | --- | --- | --- | | `QDBusConnectionInterface.DontAllowReplacement` | `0` | 不要讓其他應用程序來取代我們。該服務必須明確取消注冊[unregisterService](qdbusconnectioninterface.html#unregisterService)（ ）用于其他應用程序，以獲取它。這是默認的。 | | `QDBusConnectionInterface.AllowReplacement` | `1` | 允許其他應用程序給我們的替換[ReplaceExistingService](qdbusconnectioninterface.html#ServiceQueueOptions-enum)選項[registerService](qdbusconnectioninterface.html#registerService)（ ）不進行干預。如果發生這種情況，則[serviceUnregistered](qdbusconnectioninterface.html#serviceUnregistered)（）信號將被發射。 | **See also** [ServiceQueueOptions](qdbusconnectioninterface.html#ServiceQueueOptions-enum)。 * * * ## Method Documentation ``` QDBusConnectionInterface.connectNotify (self, SIGNAL()) ``` ``` QDBusConnectionInterface.disconnectNotify (self, SIGNAL()) ``` ``` QDBusReply QDBusConnectionInterface.isServiceRegistered (self, QString?serviceName) ``` 返回True如果服務名稱_serviceName_擁有目前登記。 ``` QDBusReply QDBusConnectionInterface.registeredServiceNames (self) ``` ``` QDBusReply QDBusConnectionInterface.registerService (self, QString?serviceName, ServiceQueueOptions?qoption?=?QDBusConnectionInterface.DontQueueService, ServiceReplacementOptions?roption?=?QDBusConnectionInterface.DontAllowReplacement) ``` 申請注冊的服務名_serviceName_在總線上。該_qoption_標志指定的D-Bus的服務器應該怎么做，如果_serviceName_已經注冊。該_roption_標志指定服務器應該允許其他應用程序來取代我們的注冊名稱。 如果服務注冊成功，[serviceRegistered](qdbusconnectioninterface.html#serviceRegistered)（）信號將被發射。如果被放置在隊列中，該信號將在我們獲得的名稱被發射。如果_roption_ is [AllowReplacement](qdbusconnectioninterface.html#ServiceReplacementOptions-enum)時，[serviceUnregistered](qdbusconnectioninterface.html#serviceUnregistered)（ ）信號會在另一個應用程序取代了這一個發射。 **See also** [unregisterService](qdbusconnectioninterface.html#unregisterService)（ ） 。 ``` QDBusReply QDBusConnectionInterface.serviceOwner (self, QString?name) ``` 返回名稱的主要所有者的唯一連接名稱_name_。如果請求的名字沒有一個老板，返回`org.freedesktop.DBus.Error.NameHasNoOwner`錯誤。 ``` QDBusReply QDBusConnectionInterface.servicePid (self, QString?serviceName) ``` 返回的Unix進程ID（PID ）為目前持有的巴士服務的過程_serviceName_。 ``` QDBusReply QDBusConnectionInterface.serviceUid (self, QString?serviceName) ``` 返回的Unix用戶ID（ UID）為目前持有的巴士服務的過程_serviceName_。 ``` QDBusReply QDBusConnectionInterface.startService (self, QString?name) ``` 要求該總線開始由給定名稱的服務_name_。 ``` QDBusReply QDBusConnectionInterface.unregisterService (self, QString?serviceName) ``` 發布于巴士服務名索賠_serviceName_，這已與以前登記[registerService](qdbusconnectioninterface.html#registerService)（ ） 。如果這個應用程序有名稱的所有權，它會被釋放用于其他應用要求。如果只有名字排隊，它放棄其在隊列中的位置。 * * * ## Qt Signal Documentation ``` void callWithCallbackFailed (const QDBusError&,const QDBusMessage&) ``` 這是該信號的默認超載。 當存在時是一個錯誤，這個信號被發射的[QDBusConnection.callWithCallback](qdbusconnection.html#callWithCallback)（ ） 。_error_指定錯誤。_call_是無法傳遞的消息。 **See also** [QDBusConnection.callWithCallback](qdbusconnection.html#callWithCallback)（ ） 。 ``` void serviceOwnerChanged (const QString&,const QString&,const QString&) ``` 這是該信號的默認超載。 這個信號是由D - Bus服務器發出每當服務所有權的變化發生在公交車，其中包括幻影的名字和disparition 。 這個信號表示該應用程序_oldOwner_的總線名稱喪失所有權_name_應用_newOwner_。如果_oldOwner_是一個空字符串，它表示的名稱_name_剛剛被創建，如果_newOwner_是空的，名稱_name_目前尚無所有者和不再可用。 **Note:**連接到該信號將使應用程序監聽并接收總線上的每一個服務的所有權變更。取決于有多少服務正在運行，這使應用程序被激活，以獲得更多的信號比它需要。要避免此問題，請使用[QDBusServiceWatcher](qdbusservicewatcher.html)類，它可以偵聽特定的變化。 ``` void serviceRegistered (const QString&) ``` 這是該信號的默認超載。 這個信號是由D-Bus的服務器當巴士服務名稱（唯一的連接名稱或知名服務名稱）由下式給出發射_serviceName_由該應用程序獲得的。 收購之后會發生這個應用程序使用請求的名稱[registerService](qdbusconnectioninterface.html#registerService)（ ） 。 ``` void serviceUnregistered (const QString&) ``` 這是該信號的默認超載。 這個信號是由D - Bus服務器時發出此應用程序失去由下式給出的巴士服務名稱的所有權_serviceName_。