roUrlEvent

6 min

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.

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
-2	CURLE_FAILED_INIT
-3	CURLE_URL_MALFORMAT
-5	CURLE_COULDNT_RESOLVE_PROXY
-6	CURLE_COULDNT_RESOLVE_HOST
-7	CURLE_COULDNT_CONNECT
-8	CURLE_FTP_WEIRD_SERVER_REPLY
-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
-13	CURLE_FTP_WEIRD_PASV_REPLY
-14	CURLE_FTP_WEIRD_227_FORMAT
-15	CURLE_FTP_CANT_GET_HOST
-17	CURLE_FTP_COULDNT_SET_TYPE
-18	CURLE_PARTIAL_FILE
-19	CURLE_FTP_COULDNT_RETR_FILE
-21	CURLE_QUOTE_ERROR	Error en el comando quote
-22	CURLE_HTTP_RETURNED_ERROR
-23	CURLE_WRITE_ERROR
-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
-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
-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
-38	CURLE_LDAP_CANNOT_BIND
-39	CURLE_LDAP_SEARCH_FAILED
-41	CURLE_FUNCTION_NOT_FOUND
-42	CURLE_ABORTED_BY_CALLBACK
-43	CURLE_BAD_FUNCTION_ARGUMENT
-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 está 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().