# QDBusUnixFileDescriptor Class Reference ## [[QtDBus](index.htm) module] 該QDBusUnixFileDescriptor類各執一份的Unix文件描述符。[More...](#details) ### Methods * `__init__ (self)` * `__init__ (self, int?fileDescriptor)` * `__init__ (self, QDBusUnixFileDescriptor?other)` * `int fileDescriptor (self)` * `bool isValid (self)` * `setFileDescriptor (self, int?fileDescriptor)` ### Static Methods * `bool isSupported ()` * * * ## Detailed Description 該QDBusUnixFileDescriptor類各執一份的Unix文件描述符。 該QDBusUnixFileDescriptor類用于容納一個Unix的文件描述符與使用[QtDBus](index.htm)模塊。這使得應用程序可以自動發送和接收的Unix文件描述符在D-Bus的連接，映射到D -總線類型的“h” 。 也可以使用如在信號和通過用QDBusConnection.registerObject注冊得到出口到D-總線時隙參數類型QDBusUnixFileDescriptors的對象。 QDBusUnixFileDescriptor不走文件描述符的所有權。相反，它將使用Unix系統調用`dup(2)`使文件描述符的副本。此文件描述符屬于QDBusUnixFileDescriptor對象，不應該被存儲或由用戶關閉。相反，你應該讓自己的副本，如果你需要的。 #### Availability Unix的文件描述符的逝世是不是適用于所有的D-Bus連接。此功能目前與D-Bus的圖書館和總線守護程序版本1.4及以上的Unix系統。[QtDBus](index.htm)自動啟用該功能，如果這樣的版本被發現在編譯時和運行時。 要驗證您的連接不支持通過文件描述符，檢查[QDBusConnection.UnixFileDescriptorPassing](qdbusconnection.html#ConnectionCapability-enum)功能設置與[QDBusConnection.connectionCapabilities](qdbusconnection.html#connectionCapabilities)（ ） 。如果標志不活躍，那么你將無法做出有QDBusUnixFileDescriptor作為參數，甚至在一個變體中嵌入這種類型的調用方法。您也不會收到包含該類型的呼叫。 另請注意，遠程應用程序可能無法讓Unix文件描述符傳遞的支持。如果你犯了一個D-Bus的到無法接受這樣一種類型的遠程應用程序，您將收到一條錯誤的答復。如果您嘗試發送一個含有D-Bus的文件描述符的信號，或從一個方法調用返回之一，該消息將被丟棄。 即使功能不可用， QDBusUnixFileDescriptor將繼續運行，所以代碼不需要有編譯時檢查此功能的可用性。 在非Unix系統， QDBusUnixFileDescriptor將始終報告無效狀態，[QDBusUnixFileDescriptor.isSupported](qdbusunixfiledescriptor.html#isSupported)（ ）將返回False 。 * * * ## Method Documentation ``` QDBusUnixFileDescriptor.__init__ (self) ``` 構造一個[QDBusUnixFileDescriptor](qdbusunixfiledescriptor.html)沒有包裝的文件描述符。這等效于一個無效的文件描述符（如-1）構成的對象。 **See also** [fileDescriptor](qdbusunixfiledescriptor.html#fileDescriptor)（）和[isValid](qdbusunixfiledescriptor.html#isValid)（ ） 。 ``` QDBusUnixFileDescriptor.__init__ (self, int?fileDescriptor) ``` 構造一個[QDBusUnixFileDescriptor](qdbusunixfiledescriptor.html)通過復制的對象_fileDescriptor_參數。原始文件的描述符是不被用戶觸摸并必須關閉。 請注意，返回的值由[fileDescriptor](qdbusunixfiledescriptor.html#fileDescriptor)（）將來自不同_fileDescriptor_參數傳遞。 如果_fileDescriptor_參數是無效的，[isValid](qdbusunixfiledescriptor.html#isValid)（ ）將返回False，[fileDescriptor](qdbusunixfiledescriptor.html#fileDescriptor)（ ）將返回-1 。 **See also** [setFileDescriptor](qdbusunixfiledescriptor.html#setFileDescriptor)（）和[fileDescriptor](qdbusunixfiledescriptor.html#fileDescriptor)（ ） 。 ``` QDBusUnixFileDescriptor.__init__ (self, QDBusUnixFileDescriptor?other) ``` 構造一個[QDBusUnixFileDescriptor](qdbusunixfiledescriptor.html)通過復制對象_other_。 ``` int QDBusUnixFileDescriptor.fileDescriptor (self) ``` 返回包含此Unix的文件描述符[QDBusUnixFileDescriptor](qdbusunixfiledescriptor.html)對象。無效的文件描述符由值-1表示。 請注意，這個函數返回的文件描述符是由擁有[QDBusUnixFileDescriptor](qdbusunixfiledescriptor.html)對象，并且必須不被保存過去的這個對象的生存期。它是確定使用它，而這個對象是有效的，但如果一個人想存放更長的使用，文件描述符應使用Unix的克隆`dup(2)`，`dup2(2)` or `dup3(2)`功能。 **See also** [setFileDescriptor](qdbusunixfiledescriptor.html#setFileDescriptor)（）和[isValid](qdbusunixfiledescriptor.html#isValid)（ ） 。 ``` bool QDBusUnixFileDescriptor.isSupported () ``` 如果在Unix文件描述符都在這個平臺上支持，則返回True 。換句話說，該函數返回True，如果這是一個Unix平臺上。 需要注意的是[QDBusUnixFileDescriptor](qdbusunixfiledescriptor.html)繼續運行，即使這個函數返回False 。唯一的區別在于[QDBusUnixFileDescriptor](qdbusunixfiledescriptor.html)對象將始終處于[isValid](qdbusunixfiledescriptor.html#isValid)（ ） == False狀態和[fileDescriptor](qdbusunixfiledescriptor.html#fileDescriptor)（ ）將總是返回-1 。本課程將不消耗任何作業系統資源。 ``` bool QDBusUnixFileDescriptor.isValid (self) ``` 返回True如果Unix的文件描述符是有效的。一個有效的Unix文件描述符不是-1 。 **See also** [fileDescriptor](qdbusunixfiledescriptor.html#fileDescriptor)（ ） 。 ``` QDBusUnixFileDescriptor.setFileDescriptor (self, int?fileDescriptor) ``` 設置文件描述符，這[QDBusUnixFileDescriptor](qdbusunixfiledescriptor.html)對象保存到副本_fileDescriptor_。原始文件的描述符是不被用戶觸摸并必須關閉。 請注意，返回的值由[fileDescriptor](qdbusunixfiledescriptor.html#fileDescriptor)（）將來自不同_fileDescriptor_參數傳遞。 如果_fileDescriptor_參數是無效的，[isValid](qdbusunixfiledescriptor.html#isValid)（ ）將返回False，[fileDescriptor](qdbusunixfiledescriptor.html#fileDescriptor)（ ）將返回-1 。 **See also** [isValid](qdbusunixfiledescriptor.html#isValid)（）和[fileDescriptor](qdbusunixfiledescriptor.html#fileDescriptor)（ ） 。