En esta página

QDBusUnixFileDescriptor Class

La clase QDBusUnixFileDescriptor contiene un descriptor de archivo de Unix. Más información...

Encabezado: #include <QDBusUnixFileDescriptor>
CMake: find_package(Qt6 REQUIRED COMPONENTS DBus)
target_link_libraries(mytarget PRIVATE Qt6::DBus)
qmake: QT += dbus

Funciones públicas

QDBusUnixFileDescriptor()
QDBusUnixFileDescriptor(int fileDescriptor)
QDBusUnixFileDescriptor(const QDBusUnixFileDescriptor &other)
~QDBusUnixFileDescriptor()
int fileDescriptor() const
bool isValid() const
void setFileDescriptor(int fileDescriptor)
void swap(QDBusUnixFileDescriptor &other)
QDBusUnixFileDescriptor &operator=(QDBusUnixFileDescriptor &&other)
QDBusUnixFileDescriptor &operator=(const QDBusUnixFileDescriptor &other)

Miembros públicos estáticos

bool isSupported()

Descripción detallada

La clase QDBusUnixFileDescriptor se utiliza para almacenar un descriptor de archivo de Unix para su uso con el módulo Qt D-Bus. Esto permite a las aplicaciones enviar y recibir descriptores de archivo de Unix a través de la conexión D-Bus, asignándolos automáticamente al tipo «h» de D-Bus.

Los objetos de tipo QDBusUnixFileDescriptor también pueden utilizarse como parámetros en señales y ranuras que se exportan a D-Bus mediante su registro con ` QDBusConnection::registerObject`.

QDBusUnixFileDescriptor no asume la propiedad del descriptor de archivo. En su lugar, utilizará la llamada al sistema de Unix dup(2) para crear una copia del descriptor de archivo. Este descriptor de archivo pertenece al objeto QDBusUnixFileDescriptor y el usuario no debe almacenarlo ni cerrarlo. En su lugar, si lo necesitas, debes crear tu propia copia.

Disponibilidad

El paso de descriptores de archivo de Unix no está disponible en todas las conexiones D-Bus. Esta característica está presente en la biblioteca D-Bus y en el demonio de bus a partir de la versión 1.4 en sistemas Unix. Qt D-Bus habilita automáticamente esta característica si se detecta dicha versión en tiempo de compilación y en tiempo de ejecución.

Para comprobar que tu conexión admite el paso de descriptores de archivo, verifica si la capacidad QDBusConnection::UnixFileDescriptorPassing está activada mediante QDBusConnection::connectionCapabilities(). Si el indicador no está activo, no podrás realizar llamadas a métodos que tengan QDBusUnixFileDescriptor como argumento ni siquiera incrustar dicho tipo en una variante. Tampoco recibirás llamadas que contengan ese tipo.

Ten en cuenta también que es posible que las aplicaciones remotas no admitan el paso de descriptores de archivo de Unix. Si realizas una llamada D-Bus a una aplicación remota que no pueda recibir dicho tipo, recibirás una respuesta de error. Si intentas enviar una señal que contenga un descriptor de archivo D-Bus o devolver uno desde una llamada a un método, el mensaje se descartará de forma silenciosa.

Aunque la función no esté disponible, `QDBusUnixFileDescriptor` seguirá funcionando, por lo que el código no necesita realizar comprobaciones en tiempo de compilación sobre la disponibilidad de esta función.

En sistemas que no sean Unix, QDBusUnixFileDescriptor siempre indicará un estado no válido y QDBusUnixFileDescriptor::isSupported() devolverá «false».

Véase también QDBusConnection::ConnectionCapabilities y QDBusConnection::connectionCapabilities().

Documentación de las funciones miembro

QDBusUnixFileDescriptor::QDBusUnixFileDescriptor()

Crea un objeto `QDBusUnixFileDescriptor` sin un descriptor de archivo envuelto. Esto equivale a crear el objeto con un descriptor de archivo no válido (como -1).

Véase también fileDescriptor() y isValid().

[explicit] QDBusUnixFileDescriptor::QDBusUnixFileDescriptor(int fileDescriptor)

Crea un objeto `QDBusUnixFileDescriptor` copiando el parámetro ` fileDescriptor `. El descriptor de archivo original no se modifica y el usuario debe cerrarlo.

Ten en cuenta que el valor devuelto por fileDescriptor() será diferente del parámetro fileDescriptor pasado.

Si el parámetro fileDescriptor no es válido, isValid() devolverá false y fileDescriptor() devolverá -1.

Véase también setFileDescriptor() y fileDescriptor().

QDBusUnixFileDescriptor::QDBusUnixFileDescriptor(const QDBusUnixFileDescriptor &other)

Crea un objeto `QDBusUnixFileDescriptor` copiando ` other`.

[noexcept] QDBusUnixFileDescriptor::~QDBusUnixFileDescriptor()

Destruye este objeto ` QDBusUnixFileDescriptor ` y libera el descriptor de archivo de Unix que contenía.

int QDBusUnixFileDescriptor::fileDescriptor() const

Devuelve el descriptor de archivo Unix que contiene este objeto ` QDBusUnixFileDescriptor `. Un descriptor de archivo no válido se representa con el valor -1.

Tenga en cuenta que el descriptor de archivo devuelto por esta función es propiedad del objeto ` QDBusUnixFileDescriptor ` y no debe almacenarse más allá de la vida útil de dicho objeto. Se puede utilizar mientras el objeto sea válido, pero si se desea almacenarlo para un uso más prolongado, el descriptor de archivo debe clonarse utilizando las funciones de Unix ` dup(2)`, ` dup2(2) ` o ` dup3(2) `.

Véanse también setFileDescriptor() y isValid().

[static] bool QDBusUnixFileDescriptor::isSupported()

Devuelve « true » si esta plataforma admite descriptores de archivo de Unix. En otras palabras, esta función devuelve « true » si se trata de una plataforma Unix.

Ten en cuenta que QDBusUnixFileDescriptor sigue funcionando aunque esta función devuelva false. La única diferencia es que los objetos QDBusUnixFileDescriptor siempre estarán en el estado isValid() == false y fileDescriptor() siempre devolverá -1. La clase no consumirá ningún recurso del sistema operativo.

bool QDBusUnixFileDescriptor::isValid() const

Devuelve ` true ` si este descriptor de archivo de Unix es válido. Un descriptor de archivo de Unix válido no es -1.

Véase también fileDescriptor().

void QDBusUnixFileDescriptor::setFileDescriptor(int fileDescriptor)

Establece el descriptor de archivo que contiene este objeto ` QDBusUnixFileDescriptor ` como una copia de ` fileDescriptor`. El descriptor de archivo original no se modifica y el usuario debe cerrarlo.

Tenga en cuenta que el valor devuelto por fileDescriptor() será diferente del parámetro fileDescriptor pasado.

Si el parámetro ` fileDescriptor ` no es válido, ` isValid()` devolverá `false` y ` fileDescriptor()` devolverá `-1`.

Véase también isValid() y fileDescriptor().

[noexcept] void QDBusUnixFileDescriptor::swap(QDBusUnixFileDescriptor &other)

Intercambia esta instancia de descriptor de archivo por other. Esta operación es muy rápida y nunca falla.

[noexcept] QDBusUnixFileDescriptor &QDBusUnixFileDescriptor::operator=(QDBusUnixFileDescriptor &&other)

Asigna « other » a este « QDBusUnixFileDescriptor ».

QDBusUnixFileDescriptor &QDBusUnixFileDescriptor::operator=(const QDBusUnixFileDescriptor &other)

Copia el descriptor de archivo de Unix del objeto other QDBusUnixFileDescriptor . Si el objeto actual contenía un descriptor de archivo, este se eliminará debidamente antes de la copia.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.