---
title: roUrlEvent
slug: develop/es/rourlevent
docTags: 
createdAt: 2025-03-26T17:42:06.875Z
---

Este evento es generado por el objeto roUrlTransfer.

## ifInt

**GetInt() como entero**

Devuelve el tipo de evento. Actualmente se definen los siguientes tipos de eventos:

- `1`: transferencia completada
- `2`: transferencia iniciada

## ifString

**GetString() As String**

Devuelve la cadena asociada con el evento. Para las solicitudes `AsyncGetToString()`, `AsyncPostFromString()`, y `AsyncPostFromFile()` completadas, este será el cuerpo de respuesta real del servidor, truncado a 65,536 caracteres.

## ifUserData

**SetUserData(user\_data As Object) As Void**

Establece los datos del usuario.

**GetUserData() As Object**

Devuelve los datos del usuario que se establecieron previamente mediante `SetUserData()` (ya sea en el evento o en el objeto de origen). Devolverá Invalid si no se ha establecido ningún dato.

## ifSourceIdentity

**GetSourceIdentity() As Integer**

Devuelve un número único que puede coincidir con el valor devuelto por roUrlTransfer.GetIdentity() para determinar dónde se originó este evento.

:::hint{type="info"}
La interfaz ifSourceIdentity ha quedado obsoleta. Recomendamos usar la interfaz ifUserData en su lugar.
:::

## ifUrlEvent

**GetResponseCode() como entero**

Devuelve el código de respuesta del protocolo asociado con un evento. Los siguientes códigos indican éxito:

- 200: Transferencia HTTP correcta
- 226: Transferencia FTP correcta
- 0: Transferencia correcta de archivo local

Para errores inesperados, el valor devuelto es negativo. Hay muchos posibles errores negativos de la biblioteca CURL, pero a menudo es mejor consultar la versión de texto llamando a `GetFailureReason()`.

Estos son algunos errores potenciales. No todos pueden ser generados por un reproductor BrightSign:

| **Estado** | **Nombre**                        | **Descripción**                                                                                                                                                                                                           |
| ---------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| -1         | CURLE\_UNSUPPORTED\_PROTOCOL      | <br /><br />                                                                                                                                                                                                              |
| -2         | CURLE\_FAILED\_INIT               | <br /><br />                                                                                                                                                                                                              |
| -3         | CURLE\_URL\_MALFORMAT             | <br /><br />                                                                                                                                                                                                              |
| -5         | CURLE\_COULDNT\_RESOLVE\_PROXY    | <br /><br />                                                                                                                                                                                                              |
| -6         | CURLE\_COULDNT\_RESOLVE\_HOST     | <br /><br />                                                                                                                                                                                                              |
| -7         | CURLE\_COULDNT\_CONNECT           | <br /><br />                                                                                                                                                                                                              |
| -8         | CURLE\_FTP\_WEIRD\_SERVER\_REPLY  | <br /><br />                                                                                                                                                                                                              |
| -9         | CURLE\_REMOTE\_ACCESS\_DENIED     | El servidor denegó un servicio debido a la falta de acceso. Cuando falla el inicio de sesión, esto no se devuelve.                                                                                                        |
| -11        | CURLE\_FTP\_WEIRD\_PASS\_REPLY    | <br /><br />                                                                                                                                                                                                              |
| -13        | CURLE\_FTP\_WEIRD\_PASV\_REPLY    | <br /><br />                                                                                                                                                                                                              |
| -14        | CURLE\_FTP\_WEIRD\_227\_FORMAT    | <br /><br />                                                                                                                                                                                                              |
| -15        | CURLE\_FTP\_CANT\_GET\_HOST       | <br /><br />                                                                                                                                                                                                              |
| -17        | CURLE\_FTP\_COULDNT\_SET\_TYPE    | <br /><br />                                                                                                                                                                                                              |
| -18        | CURLE\_PARTIAL\_FILE              | <br /><br />                                                                                                                                                                                                              |
| -19        | CURLE\_FTP\_COULDNT\_RETR\_FILE   | <br /><br />                                                                                                                                                                                                              |
| -21        | CURLE\_QUOTE\_ERROR               | Error en el comando quote                                                                                                                                                                                                 |
| -22        | CURLE\_HTTP\_RETURNED\_ERROR      | <br /><br />                                                                                                                                                                                                              |
| -23        | CURLE\_WRITE\_ERROR               | <br /><br />                                                                                                                                                                                                              |
| -25        | CURLE\_UPLOAD\_FAILED             | Error en el comando de carga.                                                                                                                                                                                             |
| -26        | CURLE\_READ\_ERROR                | No se pudo abrir/leer desde el archivo.                                                                                                                                                                                   |
| -27        | CURLE\_OUT\_OF\_MEMORY            | <br /><br />                                                                                                                                                                                                              |
| -28        | CURLE\_OPERATION\_TIMEDOUT        | Se alcanzó el tiempo de espera.                                                                                                                                                                                           |
| -30        | CURLE\_FTP\_PORT\_FAILED          | La operación FTP PORT falló.                                                                                                                                                                                              |
| -31        | CURLE\_FTP\_COULDNT\_USE\_REST    | El comando REST falló.                                                                                                                                                                                                    |
| -33        | CURLE\_RANGE\_ERROR               | El comando RANGE no funcionó.                                                                                                                                                                                             |
| -34        | CURLE\_HTTP\_POST\_ERROR          | <br /><br />                                                                                                                                                                                                              |
| -35        | CURLE\_SSL\_CONNECT\_ERROR        | Error al conectarse con SSL.                                                                                                                                                                                              |
| -36        | CURLE\_BAD\_DOWNLOAD\_RESUME      | No se pudo reanudar la descarga.                                                                                                                                                                                          |
| -37        | CURLE\_FILE\_COULDNT\_READ\_FILE  | <br /><br />                                                                                                                                                                                                              |
| -38        | CURLE\_LDAP\_CANNOT\_BIND         | <br /><br />                                                                                                                                                                                                              |
| -39        | CURLE\_LDAP\_SEARCH\_FAILED       | <br /><br />                                                                                                                                                                                                              |
| -41        | CURLE\_FUNCTION\_NOT\_FOUND       | <br /><br />                                                                                                                                                                                                              |
| -42        | CURLE\_ABORTED\_BY\_CALLBACK      | <br /><br />                                                                                                                                                                                                              |
| -43        | CURLE\_BAD\_FUNCTION\_ARGUMENT    | <br /><br />                                                                                                                                                                                                              |
| -45        | CURLE\_INTERFACE\_FAILED          | CURLOPT\_INTERFACE falló.                                                                                                                                                                                                 |
| -47        | CURLE\_TOO\_MANY\_REDIRECTS       | Detectar bucles de redirección infinitos.                                                                                                                                                                                 |
| -48        | CURLE\_UNKNOWN\_TELNET\_OPTION    | El usuario especificó una opción desconocida.                                                                                                                                                                             |
| -49        | CURLE\_TELNET\_OPTION\_SYNTAX     | Opción telnet malformada.                                                                                                                                                                                                 |
| -51        | CURLE\_PEER\_FAILED\_VERIFICATION | El certificado o la huella digital del par no se verificaron correctamente.                                                                                                                                               |
| -52        | CURLE\_GOT\_NOTHING               | Cuando este es un error específico.                                                                                                                                                                                       |
| -53        | CURLE\_SSL\_ENGINE\_NOTFOUND      | No se encontró el motor criptográfico SSL.                                                                                                                                                                                |
| -54        | CURLE\_SSL\_ENGINE\_SETFAILED     | No se puede establecer el motor criptográfico SSL como predeterminado.                                                                                                                                                    |
| -55        | CURLE\_SEND\_ERROR,               | Error al enviar datos de red.                                                                                                                                                                                             |
| -56        | CURLE\_RECV\_ERROR                | Error al recibir datos de red.                                                                                                                                                                                            |
| -58        | CURLE\_SSL\_CERTPROBLEM           | Problema con el certificado local.                                                                                                                                                                                        |
| -59        | CURLE\_SSL\_CIPHER                | No se pudo usar el cifrado especificado.                                                                                                                                                                                  |
| -60        | CURLE\_SSL\_CACERT                | Problema con el certificado de la CA (¿ruta?)                                                                                                                                                                             |
| -61        | CURLE\_BAD\_CONTENT\_ENCODING     | Codificación de transferencia no reconocida.                                                                                                                                                                              |
| -62        | CURLE\_LDAP\_INVALID\_URL         | URL de LDAP no válida.                                                                                                                                                                                                    |
| -63        | CURLE\_FILESIZE\_EXCEEDED,        | Se superó el tamaño máximo de archivo.                                                                                                                                                                                    |
| -64        | CURLE\_USE\_SSL\_FAILED,          | Falló el nivel SSL de FTP solicitado.                                                                                                                                                                                     |
| -65        | CURLE\_SEND\_FAIL\_REWIND,        | El envío de los datos requiere un reinicio que falló.                                                                                                                                                                     |
| -66        | CURLE\_SSL\_ENGINE\_INITFAILED    | No se pudo inicializar ENGINE.                                                                                                                                                                                            |
| -67        | CURLE\_LOGIN\_DENIED              | El usuario, la contraseña o un campo similar no fue aceptado y el inicio de sesión falló.                                                                                                                                 |
| -68        | CURLE\_TFTP\_NOTFOUND             | Archivo no encontrado en el servidor.                                                                                                                                                                                     |
| -69        | CURLE\_TFTP\_PERM                 | Problema de permisos en el servidor.                                                                                                                                                                                      |
| -70        | CURLE\_REMOTE\_DISK\_FULL         | Espacio en disco agotado en el servidor.                                                                                                                                                                                  |
| -71        | CURLE\_TFTP\_ILLEGAL              | Operación TFTP ilegal.                                                                                                                                                                                                    |
| -72        | CURLE\_TFTP\_UNKNOWNID            | ID de transferencia desconocido.                                                                                                                                                                                          |
| -73        | CURLE\_REMOTE\_FILE\_EXISTS       | El archivo ya existe.                                                                                                                                                                                                     |
| -74        | CURLE\_TFTP\_NOSUCHUSER           | No existe dicho usuario.                                                                                                                                                                                                  |
| -75        | CURLE\_CONV\_FAILED               | La conversión falló.                                                                                                                                                                                                      |
| -76        | CURLE\_CONV\_REQD                 | El llamador debe registrar callbacks de conversión mediante las siguientes opciones de URL\_easy\_setopt: CURLOPT\_CONV\_FROM\_NETWORK\_FUNCTION CURLOPT\_CONV\_TO\_NETWORK\_FUNCTION CURLOPT\_CONV\_FROM\_UTF8\_FUNCTION |
| -77        | CURLE\_SSL\_CACERT\_BADFILE       | No se pudo cargar el archivo CACERT; falta o tiene un formato incorrecto.                                                                                                                                                 |
| -78        | CURLE\_REMOTE\_FILE\_NOT\_FOUND   | No se encontró el archivo remoto.                                                                                                                                                                                         |
| -79        | CURLE\_SSH                        | Error de la capa SSH (esto es algo genérico, por lo que el mensaje de error será importante cuando esto ocurra).                                                                                                          |
| -80        | CURLE\_SSL\_SHUTDOWN\_FAILED      | No se pudo cerrar la conexión SSL.                                                                                                                                                                                        |

Los siguientes códigos de error son generados por el software del sistema y están fuera del rango de eventos de CURL:

| **Estado** | **Nombre**       | **Descripción**                                                                                                         |
| ---------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
| -10001     | ERROR\_CANCELLED | La solicitud de transferencia ha sido cancelada porque la instancia de *roUrlTransfer&#x20;*&#x65;stá fuera de alcance. |
| -10002     | ERROR\_EXCEPTION | La devolución de llamada generó una excepción.                                                                          |

**GetObject() As Object**

Devuelve el objeto asociado con el evento. Actualmente, este método solo puede devolver un objeto creado en respuesta a una solicitud roUrlTransfer.AsyncGetToObject.

**GetFailureReason() como cadena**

Devuelve una descripción del fallo que ocurrió.

**GetSourceIdentity() As Integer**

Devuelve un número único que puede coincidir con el valor devuelto por roUrlTransfer.GetIdentity() para determinar de dónde provino el evento.

**GetResponseHeaders() como roAssociativeArray**

Devuelve un arreglo asociativo que contiene todos los encabezados devueltos por el servidor para los protocolos adecuados (como HTTP).

**GetHash() As String**

El hash (resumen) del cuerpo de la respuesta, según lo especificado por el parámetro `response_pipe{hash:}` del método roUrlTransfer.AsyncMethod().

**GetPrefix() As String**

Una cantidad de bytes desde el inicio del cuerpo de la respuesta. La cantidad de bytes se especifica con el parámetro `response_pipe{prefix_capture:}` del método roUrlTransfer.AsyncMethod().
