FUENTE: Microsoft Developed Network (MSDN) El control WinSock permite conectarse a un equipo remoto e intercambiar datos con el Protocolo de datagramas de usuario (UDP) o con el Protocolo de control de transmisión (TCP). Ambos protocolos se pueden usar para crear aplicaciones cliente-servidor. Al igual que el control Timer, el control WinSock no tiene una interfaz visible en tiempo de ejecución. Aplicaciones posibles • Crear una aplicación cliente que recopile información del usuario antes de enviarla a un servidor central. • Crear una aplicación servidora que funcione como un punto central de recopilación de datos procedentes de varios usuarios. • Crear una aplicación de "conversación". Seleccionar un protocolo Cuando utilice el control WinSock, primero debe tener en cuenta es si se va a usar el protocolo TCP o el protocolo UDP. La principal diferencia entre los dos radica en su estado de conexión: • TCP es un protocolo basado en la conexión y es análogo a un teléfono: el usuario debe establecer una conexión antes de continuar. • UDP es un protocolo sin conexión y la transacción entre los dos equipos es como pasar una nota: se envía un mensaje desde un equipo a otro, pero no existe una conexión explícita entre ambos. Además, el tamaño máximo de los datos en envíos individuales está determinado por la red. La naturaleza de la aplicación que esté creando determinará generalmente qué protocolo debe seleccionar. He aquí varias cuestiones que pueden ayudarle a seleccionar el protocolo adecuado: 1. ¿Necesitará la aplicación la confirmación por parte del cliente o el servidor cuando se envíen o reciban datos? Si es así, el protocolo TCP requiere una conexión explícita antes de enviar o recibir datos. 2. ¿Será muy grande el tamaño de los datos (como en el caso de los archivos de imágenes o sonidos)? Una vez establecida la conexión, el protocolo TCP mantiene la conexión y asegura la integridad de los datos. No obstante, esta conexión utiliza más recursos del sistema, por lo que resulta más "cara". 3. ¿Se enviarán los datos de forma intermitente o en una sesión? Por ejemplo, si está creando una aplicación que avisa a equipos específicos cuando se han completado

ciertas tareas, el protocolo UDP puede ser el más apropiado. Este protocolo es también el más adecuado para enviar pequeñas cantidades de datos. Establecer el protocolo Para establecer el protocolo que la aplicación va a usar: en tiempo de diseño, en la ventana Propiedades, haga clic en Protocolo y seleccione sckTCPProtocol o sckUDPProtocol. También puede establecer la propiedad Protocol en el código, como se muestra a continuación: Código: Winsock1.Protocol = sckTCPProtocol Determinar el nombre del equipo Para conectarse a un equipo remoto, deberá saber su dirección IP o su "nombre descriptivo". La dirección IP está formada por un conjunto de tres dígitos separados por puntos (xxx.xxx.xxx.xxx). En general, es mucho más fácil recordar el nombre descriptivo de un equipo. Para encontrar el nombre del equipo: 1. En la Barra de tareas del equipo, haga clic en Inicio. 2. En el elemento Configuración, haga clic en Panel de control. 3. Haga doble clic en el icono Red. 4. Haga clic en la ficha Identificación. 5. El nombre del equipo aparecerá en el cuadro Nombre del equipo. Después de encontrar el nombre del equipo, puede usarlo como el valor de la propiedad RemoteHost. Conceptos básicos de conexión con el protocolo TCP Cuando crea una aplicación que utilice el protocolo TCP, deberá decidir primero si la aplicación va a ser un servidor o un cliente. Si crea un servidor, la aplicación va a "escuchar" en el puerto designado. Cuando el cliente realice una solicitud de conexión, el servidor puede aceptar la solicitud y completar así la conexión. Una vez realizada la conexión, el cliente y el servidor se podrán comunicar entre sí sin problemas. Para crear un servidor rudimentario, realice los siguientes pasos: Para crear un servidor TCP

1. Cree un nuevo proyecto EXE estándar. 2. Cambie el nombre del formulario predeterminado a frmServer. 3. Cambie el título del formulario a "Servidor TCP". 4. Cree un control Winsock en el formulario y cambie su nombre a tcpServer. 5. Agregue dos controles TextBox al formulario. Llame al primero txtSendData y al segundo txtOutput. 6. Agregue el código siguiente al formulario. Código: Private Sub Form_Load() ' Establece la propiedad LocalPort en un entero. ' Después invoca el método Listen. tcpServer.LocalPort = 1001 tcpServer.Listen frmClient.Show ' Muestra el formulario del cliente. End Sub Private Sub tcpServer_ConnectionRequest _ (ByVal requestID As Long) ' Comprueba si el estado del control es cerrado. ' De lo contrario, cierra la conexión antes de ' aceptar la nueva conexión. If tcpServer.State <> sckClosed Then _ tcpServer.Close ' Acepta la petición con el parámetro ' requestID. tcpServer.Accept requestID End Sub Private Sub txtSendData_Change() ' El control TextBox llamado txtSendData ' contiene los datos que se van a enviar. Siempre ' que el usuario escribe en el cuadro de texto, ' se envía la cadena mediante el método SendData. tcpServer.SendData txtSendData.Text End Sub Private Sub tcpServer_DataArrival _ (ByVal bytesTotal As Long) ' Declara una variable para los datos entrantes. ' Invoca el método GetData y establece la propiedad ' Text de un control TextBox llamado txtOutput ' con los datos.

Dim strData As String tcpServer.GetData strData txtOutput.Text = strData End Sub Los procedimientos anteriores permiten crear una aplicación de servidor sencilla. No obstante, para completar el ejemplo, deberá crear también una aplicación cliente. Para crear un cliente de TCP 1. Agregue un nuevo formulario al proyecto y llámelo frmClient. 2. Cambie el título del formulario a "Cliente TCP". 3. Agregue un control Winsock al formulario y llámelo tcpClient. 4. Agregue dos controles TextBox a frmClient. Llame al primero txtSend y al segundo txtOutput. 5. Cree un control CommandButton en el formulario y llámelo cmdConnect. 6. Cambie el título del control CommandButton a Connect. 7. Agregue el código siguiente al formulario. Importante Asegúrese de que cambia el valor de la propiedad RemoteHost al nombre descriptivo del equipo. Código: Private Sub Form_Load() ' El nombre del control Winsock es tcpClient. ' Nota: para especificar un host remoto, puede usar ' la dirección IP (como "121.111.1.1") o ' el nombre "descriptivo" del equipo, como se muestra aquí. tcpClient.RemoteHost = "NombreEquipoRemoto" tcpClient.RemotePort = 1001 End Sub Private Sub cmdConnect_Click() ' Invoca el método Connect para iniciar ' una conexión. tcpClient.Connect End Sub Private Sub txtSendData_Change() tcpClient.SendData txtSend.Text End Sub

Private Sub tcpClient_DataArrival _ (ByVal bytesTotal As Long) Dim strData As String tcpClient.GetData strData txtOutput.Text = strData End Sub El código anterior crea una aplicación cliente-servidor sencilla. Para probar las dos aplicaciones al mismo tiempo, ejecute el proyecto y haga clic en Conectar. A continuación, escriba texto en el control TextBox txtSendData de cualquiera de los formularios y el mismo texto aparecerá en el control TextBox txtOutput del otro formulario. Aceptar más de una solicitud de conexión El servidor básico comentado anteriormente sólo acepta una solicitud de conexión. No obstante, es posible aceptar varias solicitudes de conexión con el mismo control si crea una matriz de controles. En este caso, no necesita cerrar la conexión; basta con crear una nueva instancia del control (estableciendo la propiedad Index) e invocar el método Accept de la nueva instancia. El código que se muestra a continuación presupone que existe un control Winsock en un formulario llamado sckServer y que su propiedad Index tiene el valor 0, por lo que el control forma parte de una matriz de controles. En la sección Declaraciones se declara una variable intMax a nivel de módulo. En el evento Load del formulario, intMax tiene establecido el valor 0 y la propiedad LocalPort del primer control de la matriz tiene el valor 1001. Después, se invoca el método Listen en el control, convirtiéndolo en el control "que escucha". A medida que llega cada solicitud de conexión, el código comprueba si el índice es 0 (el valor del control "que escucha"). Si es así, este control aumenta la variable intMax y utiliza ese número para crear una nueva instancia del control. Esta instancia se utiliza para aceptar la solicitud de conexión. Código: Private intMax As Long Private Sub Form_Load() intMax = 0 sckServer(0).LocalPort = 1001 sckServer(0).Listen End Sub Private Sub sckServer_ConnectionRequest _ (Index As Integer, ByVal requestID As Long) If Index = 0 Then intMax = intMax + 1 Load sckServer(intMax) sckServer(intMax).LocalPort = 0

sckServer(intMax).Accept requestID Load txtData(intMax) End If End Sub Conceptos básicos del protocolo UDP Crear una aplicación UDP es todavía más sencillo que crear una aplicación TCP, ya que el protocolo UDP no requiere una conexión explícita. En la aplicación TCP anterior hubo que establecer explícitamente un control Winsock para "escuchar", mientras que el otro debía iniciar la conexión con el método Connect. En cambio, el protocolo UDP no requiere una conexión explícita. Para enviar datos entre los dos controles, se deben completar tres pasos (en ambos lados de la conexión): 1. Establezca la propiedad RemoteHost con el nombre del otro equipo. 2. Establezca la propiedad RemotePort con la propiedad LocalPort del segundo control. 3. Invoque el método Bind especificando la propiedad LocalPort que se va a usar. (Este método se trata detenidamente más adelante.) Debido a que ambos equipos se pueden considerar "iguales" en la relación, se podría llamar una aplicación de igual a igual. Para demostrarlo, el siguiente código crea una aplicación de "conversación" que permite que dos personas "conversen" en tiempo real: Para crear una aplicación UDP de igual a igual 1. Cree un proyecto EXE estándar. 2. Cambie el nombre del formulario predeterminado a frmPeerA. 3. Cambie el título del formulario a "Igual A". 4. Cree un control Winsock en el formulario y llámelo udpPeerA. 5. En la página Propiedades, haga clic en Protocolo y cambie el protocolo a UDPProtocol. 6. Agregue dos controles TextBox al formulario. Llame al primero txtSend y al segundo txtOutput. 7. Agregue el siguiente código al formulario. Código: Private Sub Form_Load() ' El nombre del control es udpPeerA.

With udpPeerA ' IMPORTANTE: asegúrese de cambiar el valor de ' RemoteHost al nombre de su equipo. .RemoteHost= "IgualB" .RemotePort = 1001 ' Puerto al que conectar. .Bind 1002 ' Enlaza al puerto local. End With frmPeerB.Show ' Muestra el segundo formulario. End Sub Private Sub txtSend_Change() ' Envía texto en cuanto se escribe. udpPeerA.SendData txtSend.Text End Sub Private Sub udpPeerA_DataArrival _ (ByVal bytesTotal As Long) Dim strData As String udpPeerA.GetData strData txtOutput.Text = strData End Sub Para crear una segunda aplicación UDP de igual a igual 1. Agregue un formulario estándar al proyecto. 2. Cambie el nombre del formulario a frmPeerB. 3. Cambie el título del formulario a "Igual B". 4. Cree un control Winsock en el formulario y llámelo udpPeerB. 5. En la página Propiedades, haga clic en Protocolo y cambie el protocolo a UDPProtocol. 6. Agregue dos controles TextBox al formulario. Llame al primero txtSend y al segundo txtOutput. 7. Agregue el siguiente código al formulario. Código: Private Sub Form_Load() ' El nombre del control es udpPeerB. With udpPeerB ' IMPORTANTE: asegúrese de cambiar el valor de ' RemoteHost al nombre de su equipo. .RemoteHost= "IgualA" .RemotePort = 1002 ' Puerto al que conectar.

.Bind 1001 ' Enlaza al puerto local. End With End Sub Private Sub txtSend_Change() ' Envía texto en cuanto se escribe. udpPeerB.SendData txtSend.Text End Sub Private Sub udpPeerB_DataArrival _ (ByVal bytesTotal As Long) Dim strData As String udpPeerB.GetData strData txtOutput.Text = strData End Sub Para probar el ejemplo, presione F5 para ejecutar el proyecto y escriba texto en el control TextBox txtSend de cualquiera de los formularios. El mismo texto aparecerá en el control TextBox txtOutput del otro formulario. Acerca del método Bind Tal como ilustra el código anterior, debe invocar el método Bind al crear una aplicación UDP. Este método "reserva" un puerto local para uso del control. Por ejemplo, al enlazar el control al número de puerto 1001, ninguna otra aplicación podrá usar ese puerto para "escuchar". Esto puede ser muy útil si desea impedir que otra aplicación utilice ese puerto. El método Bind también ofrece un segundo argumento opcional. Si hay más de un adaptador de red presente en el equipo, el argumento IPlocal permite especificar qué adaptador usar. Si omite este argumento, el control usará el primer adaptador de red que aparece en la lista del cuadro de diálogo Red de la opción Configuración del Panel de control. Si utiliza el protocolo UDP, puede cambiar libremente las propiedades RemoteHost y RemotePort mientras permanezca conectado al mismo puerto local. No obstante, con el protocolo TCP deberá cerrar la conexión antes de cambiar las propiedades RemoteHost y RemotePort. Winsock (Control) El control Winsock, invisible para el usuario, proporciona un acceso sencillo a los servicios de red TCP y UDP. Pueden usarlo los programadores de Microsoft Access, Visual Basic, Visual C++ o Visual FoxPro. Para escribir aplicaciones de servidor o de cliente no necesita comprender los detalles de TCP ni llamar a las API de Winsock de

nivel inferior. Si establece las propiedades y llama a los métodos del control, podrá conectar fácilmente con un equipo remoto e intercambiar datos en las dos direcciones. Conceptos básicos de TCP El Protocolo de control de transferencia (TCP) le permite crear y mantener una conexión con un equipo remoto. Mediante la conexión, ambos equipos pueden intercambiar datos entre sí. Si está creando una aplicación de cliente, debe saber el nombre del equipo servidor o su dirección IP (propiedad RemoteHost), así como el puerto (propiedad RemotePort) en el que está "escuchando". Después, llame al método Connect. Si está creando una aplicación de servidor, establezca el puerto (propiedad LocalPort) en el que escuchar y llame al método Listen. Cuando el equipo cliente solicite una conexión, se producirá el evento ConnectionRequest. Para completar la conexión, llame al método Accept del evento ConnectionRequest. Una vez establecida la conexión, los equipos pueden enviar y recibir datos. Para enviar datos, llame al método SendData. Siempre que se reciben datos, se produce el evento DataArrival. Llame al método GetData del evento DataArrival para recuperar los datos. Conceptos básicos de UDP El Protocolo de datagramas de usuarios (UDP) es un protocolo sin conexiones. A diferencia de las operaciones de TCP, los equipos no establecen una conexión. Asimismo, una aplicación UDP puede ser cliente o servidor. Para transmitir datos, establezca primero la propiedad LocalPort del equipo cliente. El equipo servidor sólo necesita establecer RemoteHost a la dirección de Internet del equipo cliente y la propiedad RemotePort al mismo puerto que la propiedad LocalPort del equipo cliente, y llamar al método SendData para comenzar a enviar mensajes. Después, el equipo cliente utiliza el método GetData del evento DataArrival para recuperar los mensajes enviados. Propiedades Winsock(control) BytesReceived (Propiedad) Devuelve la cantidad de datos recibidos (que están actualmente en el búfer de recepción). Utilice el método GetData para recuperar los datos. Es de sólo lectura y no está disponible en tiempo de diseño. Sintaxis objeto.BytesReceived

Valor devuelto Long LocalHostName (Propiedad) Devuelve el nombre de la máquina local. Es de sólo lectura y no está disponible en tiempo de diseño. Sintaxis objeto.LocalHostName Valor devuelto String LocalIP (Propiedad) Devuelve la dirección IP de la máquina local en el formato de cadena con puntos de dirección IP (xxx.xxx.xxx.xxx). Es de sólo lectura y no está disponible en tiempo de diseño. Sintaxis objeto.LocalIP Tipo de datos String LocalPort (Propiedad) Devuelve o establece el puerto local que desea usar. Es de lectura y escritura, y está disponible en tiempo de diseño. • En el cliente, designa el puerto local desde el que desea enviar los datos. Especifique el puerto 0 si la aplicación no necesita un puerto específico. En este caso, el control seleccionará un puerto de forma aleatoria. Una vez establecida la conexión, éste es el puerto local utilizado para la conexión TCP. • En el servidor, es el puerto local en el que se escuchará. Si especifica el puerto 0, se utiliza un puerto seleccionado de forma aleatoria. Después de llamar al método Listen, la propiedad contiene el puerto actual seleccionado. Sintaxis objeto.LocalPort = largo Tipo de datos Long Comentarios

Para establecer dinámicamente conexiones entre dos equipos, se suele usar el puerto 0. Por ejemplo, un cliente que desea que un servidor le "devuelva la llamada" puede usar el puerto 0 para obtener un nuevo número de puerto (aleatorio), que pueda proporcionar al equipo remoto para ese propósito. Protocol (Propiedad, control Winsock) Devuelve o establece el protocolo, TCP o UDP, utilizado por el control Winsock. Sintaxis objeto.Protocol [=protocolo] Valores Los valores de protocolo son: Código: Constante Valor Descripción sckTCPProtocol 0 Predeterminado. Protocolo TCP. sckUDPProtocol 1 Protocolo UDP. Valor devuelto Ninguno Comentarios Debe cerrar el control (con el método Close) antes de que se pueda restablecer esta propiedad. RemoteHostIP (Propiedad) Devuelve la dirección IP del equipo remoto. • En las aplicaciones de cliente, después de establecer la conexión con el método Connect, esta propiedad contiene la cadena IP del equipo remoto. • En las aplicaciones de servidor, después de la llegada de una solicitud de llamada (evento ConnectionRequest), esta propiedad contiene la cadena IP del equipo remoto que inició la conexión. • Cuando utiliza el protocolo UDP, después de producirse el evento DataArrival, esta propiedad contiene la dirección IP del equipo que envía los datos UDP. Sintaxis objeto.RemoteHostIP Tipo de datos String

SocketHandle (Propiedad) Devuelve un valor que corresponde al controlador de socket que utiliza el control para comunicarse con la capa Winsock. Es de sólo lectura y no está disponible en tiempo de diseño. Sintaxis objeto.SocketHandle Tipo de datos Long Comentarios Esta propiedad se diceñó para pasarla a las API de Winsock. State (Propiedad, control Winsock) Devuelve el estado del control, expresado como un tipo enumerado. Es de sólo lectura y no está disponible en tiempo de diseño. Sintaxis objeto.State Tipo de datos Integer Valores Los valores de la propiedad State son: Código: Constante Valor Descripción sckClosed 0 Predeterminado. Cerrado sckOpen 1 Abierto sckListening 2 Escuchando sckConnectionPending 3 Conexión pendiente sckResolvingHost 4 Resolviendo host sckHostResolved 5 Host resuelto sckConnecting 6 Conectando sckConnected 7 Conectado sckClosing 8 El equipo está cerrando la conexión sckError 9 Error Index (Propiedad, controles ActiveX)

Establece o devuelve el número que identifica inequívocamente un objeto de una colección. Sintaxis objeto.Index Comentarios La propiedad Index se establece de forma predeterminada al orden de creación de los objetos en una colección. El índice para el primer objeto de una colección será siempre uno (1). El valor de la propiedad Index de un objeto puede cambiar cuando se ordenan de nuevo los objetos de la colección, como cuando establece la propiedad Sorted a True. Si espera que la propiedad Index cambie dinámicamente, puede que sea más útil hacer referencia a los objetos de una colección mediante la propiedad Key. Name (Propiedad) • Devuelve el nombre utilizado en el código para identificar un formulario, un control o un objeto de acceso a datos. Es de sólo lectura en tiempo de ejecución. • Devuelve o establece el nombre de un objeto fuente. Sintaxis objeto.Name Comentarios El nombre predeterminado para objetos nuevos es el tipo de objeto y un entero único. Por ejemplo, el primer objeto Form nuevo será Form1, un objeto MDIForm nuevo será MDIForm1 y el tercer control TextBox que cree en un formulario será Text3. La propiedad Name de un objeto debe comenzar por una letra y puede tener un máximo de 40 caracteres. Puede incluir números y caracteres de subrayado (_), pero no signos de puntuación ni espacios en blanco. Un formulario no puede tener el mismo nombre que otro objeto público como Clipboard, Screen o App. Aunque el valor de la propiedad Name puede ser una palabra clave, un nombre de propiedad o el nombre de otro objeto, esto puede crear conflictos en el código. Puede usar la propiedad Name de un formulario con la instrucción Dim en tiempo de ejecución para crear otras instancias del formulario. No puede haber dos formularios con el mismo nombre en tiempo de diseño. Puede crear un conjunto de controles del mismo tipo si establece la propiedad Name al mismo valor. Por ejemplo, cuando establece el nombre de todos los botones de opción en un grupo como MiOpc, Visual Basic asigna valores únicos a la propiedad Index de cada

control con el fin de distinguir unos de otros en la matriz. Dos controles de distinto tipo no pueden tener el mismo nombre. Nota Aunque Visual Basic usa a menudo el valor de la propiedad Name como valor predeterminado de las propiedades Caption, LinkTopic y Text, el cambio de una de estas propiedades no afecta a las otras. Cambiar mayúsculas/minúsculas del valor de la propiedad Name para un Formulario u otro módulo sin cambiar el nombre puede producir un mensaje de error del tipo "Conflicto de nombres" la próxima vez que se cargue el proyecto que contiene el formulario o el módulo. Por ejemplo, cambiar "Form1" a "form1" producirá el error; cambiar "Form1" a "formX" no lo hará. El error es causado por la forma en que se guardan los nombres de los módulos en el archivo del proyecto; el procedimiento para cambiar nombres dentro del archivo del proyecto no distingue mayúsculas de minúsculas, mientras que el procedimiento para leer nombres al cargar el proyecto sí las distingue. Object (Propiedad, controles ActiveX) Devuelve el objeto y un valor de un método o propiedad de un objeto. Sintaxis objeto.Object[.propiedad | .método] La sintaxis de la propiedad Object consta de las siguientes partes: Código: Parte Descripción objeto Una expresión de objeto que da como resultado un objeto de la lista Se aplica a. propiedad Propiedad compatible con el objeto. método Método compatible con el objeto. Comentarios Utilice esta propiedad para especificar un objeto que desea usar en una tarea de Automatización. Para usar en una tarea de Automatización el objeto devuelto por la propiedad Object, utilice las propiedades y los métodos de dicho objeto. Para obtener información acerca de las propiedades y los métodos compatibles con un objeto, vea la documentación de la aplicación que creó el objeto. Parent (Propiedad)

Devuelve el formulario, objeto o colección que contiene un control u otro objeto o colección. Sintaxis objeto.Parent Comentarios Utilice la propiedad Parent para tener acceso a las propiedades, los métodos o los controles del primario de un objeto. Por ejemplo: Código: MiBotón.Parent.MousePointer = 4 La propiedad Parent es útil en una aplicación en la que se pasan objetos como argumentos. Por ejemplo, podría pasar una variable de control a un procedimiento general en un módulo y usar la propiedad Parent para tener acceso a su formulario primario. No hay ninguna relación entre la propiedad Parent y la propiedad MDIChild. Sin embargo, hay una relación primario-secundario entre un objeto MDIForm y cualquier objeto Form que tenga su propiedad MDIChild establecida a True. RemoteHost (Propiedad, controles ActiveX) Devuelve o establece el equipo remoto al que un control envía datos, o aquél del que los recibe. Puede indicar el nombre de host, como "http://FTP://ftp.microsoft.com" o como una cadena de dirección IP en el formato con puntos, como "100.0.1.1". Sintaxis objeto.RemoteHost = cadena La sintaxis de la propiedad RemoteHost consta de las siguientes partes: Código: Parte Descripción objeto Una expresión de objeto que da como resultado un objeto de la lista Se aplica a. cadena El nombre o la dirección del equipo remoto. Comentarios Cuando se especifica esta propiedad, la propiedad URL se actualiza para mostrar el nuevo valor. Además, si se actualiza la parte de host de la dirección URL, esta propiedad también se modifica para reflejar el nuevo valor. La propiedad RemoteHost también puede modificarse al invocar los métodos OpenURL o Execute.

En tiempo de ejecución, el cambio de este valor no tiene ningún efecto hasta la conexión siguiente. RemotePort (Propiedad, controles ActiveX) Devuelve o establece el número del puerto remoto con el que conectar. Sintaxis objeto.RemotePort = puerto La sintaxis de la propiedad RemotePort consta de la siguientes partes: Código: Parte Descripción objeto Control Winsock puerto El puerto con el que conectar. El valor predeterminado de esta propiedad es 80. Tipo de dato Integer Comentarios Al establecer la propiedad Protocol, en la propiedad RemotePort se establece automáticamente el puerto predeterminado correspondiente a cada protocolo. Los números de puerto predeterminados se muestran en la siguiente tabla: Código: Puerto Descripción 80 HTTP, utilizado habitualmente para las conexiones con el World Wide Web. 21 FTP. Tag (Propiedad, controles ActiveX) Devuelve o establece una expresión que almacena cualquier dato adicional necesario para su programa. A diferencia de otras propiedades, Visual Basic no usa el valor de la propiedad Tag; puede usarla para identificar objetos. Sintaxis objeto.Tag [= expresión] La sintaxis de la propiedad Tag consta de las siguientes partes: Código:

Parte Descripción objeto Casi cualquier objeto de Visual Basic expresión Cualquier texto Comentarios Puede usar esta propiedad para asignar una cadena de identificación a un objeto sin afectar a los valores de ninguna otra de sus propiedades o causar efectos colaterales. La propiedad Tag es útil cuando necesita comprobar la identidad de un control o de un objeto MDIForm que se pasa como variable a un procedimiento. Sugerencia Cuando cree una nueva instancia de un formulario, asigne un valor único a la propiedad Tag. Nota La propiedad Tag es de tipo Variant para las colecciones de controles ActiveX como objetos Toolbar Button, TreeView Node, ListView ListItem y ColumnHeader, ImageList ListImage, TabStrip Tab y StatusBar Panel. Puede usar la propiedad Tag para pasar valores, pero no está permitido pasar objetos. Winsock(Metodos) Accept (Método) Sólo para las aplicaciones de servidor TCP. Este método se utiliza para aceptar una conexión entrante cuando se está tratando un evento ConnectionRequest. Sintaxis objeto.Accept IdSolicitud Tipo de datos Long Valor devuelto Ninguno Comentarios El método Accept se utiliza en el evento ConnectionRequest. El evento ConnectionRequest tiene un argumento, el parámetro RequestID, que debe pasarse al método Accept. A continuación se muestra un ejemplo: Código: Private Sub Winsock1_ConnectionRequest _ (ByVal requestID As Long) ' Cierra la conexión si está abierta mediante la

' comprobación de la propiedad State. If Winsock1.State <> sckClosed Then Winsock1.Close ' Pasa el valor del parámetro IdSolicitud ' al método Accept. Winsock1.Accept IdSolicitud End Sub Debe usar el método Accept en una nueva instancia del control (distinta de la que está en estado de escucha.) Bind (Método) Especifica el puerto local y la dirección IP local a usar en las conexiones TCP. Utilice este método si tiene múltiples adaptadores de protocolo. Sintaxis objeto.Bind puertoLocal, IPLocal La sintaxis del método Bind consta de las siguientes partes: Código: Parte Descripción objeto Control Winsock puertoLocal Puerto utilizado para realizar una conexión. IPLocal Dirección local de Internet utilizada para realizar una conexión. Comentarios Debe llamar al método Bind antes de llamar al método Listen. Close (Método, control Winsock) Cierra una conexión TCP o un socket en escucha para las aplicaciones de cliente y de servidor. Sintaxis objeto.Close Argumentos Ninguno Valor devuelto Ninguno

GetData (Método, control Winsock) Recupera el bloque actual de datos y lo almacena en una variable de tipo Variant. Valor devuelto Ninguno Sintaxis objeto.GetData datos, [tipo,] [longMáx] La sintaxis del método GetData consta de las siguientes partes: Código: Parte Descripción objeto Control Winsock datos Dónde se almacenarán los datos recuperados después de que el método termine correctamente. Si no hay suficientes datos disponibles para el tipo requerido, datos se establecerá a Vacío. tipo Opcional. Tipo de datos a recuperar, como se muestra en Valores. longMáx Opcional. Especifica el tamaño deseado cuando se recibe una matriz de bytes o una cadena. Si se omite este parámetro para las matrices de bytes o las cadenas, se recuperarán todos los datos disponibles. Si se proporciona para tipos de datos que no sean matrices de bytes o cadenas, se pasa por alto el parámetro. Valores Los valores de tipo son: Código: Descripción Constante Byte VbByte Entero VbInteger Largo VbLong Simple VbSingle Doble vbDouble Moneda vbCurrency Fecha vbDate Booleano vbBoolean SCODE vbError Cadena vbString Matriz de bytes vbArray + vbByte Comentarios El método GetData se suele usar con el evento DataArrival, que incluye el argumento bytesTotales. Si especifica una longMáx menor que el argumento bytesTotales, obtendrá el mensaje de advertencia 10040, que indica que se perderán los bytes restantes.

Ejemplo del método GetData (Control Winsock, evento DataArrival) En este ejemplo se utiliza el método GetData del evento DataArrival de un control Winsock. Cuando se produce el evento, el código llama al método GetData para recuperar los datos y los almacena en una variable de cadena. Después se escriben los datos en un control TextBox. Código: Private Sub Winsock1_DataArrival _ (ByVal bytesTotales As Long) Dim strData As String Winsock1.GetData strData, vbString Text1.Text = Text1.Text & strData End Sub Listen (Método) Crea un socket y lo establece a modo de escucha. Este método sólo funciona en las conexiones TCP. Sintaxis objeto.Listen Argumentos Ninguno Valor devuelto Ninguno Comentarios El evento ConnectionRequest se produce cuando hay una conexión entrante. Cuando se está tratando un evento ConnectionRequest, la aplicación debería usar el método Accept (en una nueva instancia del control) para aceptar la conexión. PeekData (Método) Similar a GetData, excepto que PeekData no elimina los datos de la cola de entrada. Este método sólo funciona en las conexiones TCP. Sintaxis objeto.PeekData datos, [tipo,] [longMáx] La sintaxis del método PeekData consta de las siguientes partes: Código: Parte Descripción

objeto Control Winsock datos Almacena los datos recuperados después de que el método acaba satisfactoriamente. Si no hay suficientes datos disponibles para el tipo solicitado, datos se establecerá a Vacío. tipo Opcional. Tipo de los datos a recuperar, como se describe en Valores. Valor predeterminado: vbArray + vbByte. longMáx Opcional. Longitud que especifica el tamaño deseado cuando se recibe una matriz de bytes o una cadena. Si falta este argumento para las matrices de bytes o cadenas, se recuperan todos los datos disponibles. Si se proporciona para otros tipos de datos que no sean matrices de bytes o cadenas, se pasa por alto el argumento. Valores Los valores de tipo son: Código: Tipo Constante Byte VbByte Entero VbInteger Largo VbLong Simple VbSingle Doble VbDouble Moneda vbCurrency Fecha VbDate Booleano VbBoolean SCODE VbError Cadena VbString Matriz de bytes VbArray + vbByte Valor devuelto Ninguno Comentarios Si el tipo se especifica como vbString, la cadena de datos se convierte a UNICODE antes de devolverla al usuario. SendData (Método) Envía datos a un equipo remoto. Valor devuelto Ninguno Sintaxis objeto.SendData datos La sintaxis del método SendData consta de las siguientes partes:

Código: Parte Descripción objeto Control Winsock datos Datos que desea enviar. Para los datos binarios, debería usar matrices de datos. Comentarios Cuando pasa una cadena UNICODE, se convierte a cadena ANSI antes de enviarla a la red. Winsock(eventos) Close (Evento) Se produce cuando el equipo remoto cierra la conexión. Las aplicaciones deben usar el método Close para cerrar correctamente una conexión TCP. Sintaxis objeto_Close( ) Argumentos Ninguno Connect (Evento, control Winsock) Ocurre cuando se ha completado una operación de conexión. Sintaxis objeto.Connect() Comentarios Use el evento Connect para confirmar que se ha realizado con éxito la conexión ConnectionRequest (Evento) Se produce cuando el equipo remoto solicita una conexión. • Sólo para aplicaciones de servidor TCP. El evento se activa cuando llega una solicitud de conexión. Las propiedades RemoteHostIP y RemotePort almacenan la información acerca del cliente después de que se ha activado el evento. Sintaxis objeto_ConnectionRequest (IdSolicitud As Long) La sintaxis del evento ConnectionRequest consta de las siguientes partes:

Código: Parte Descripción objeto Control Winsock IdSolicitud Identificador de la solicitud de conexión entrante. Este argumento se debería pasar al método Accept de la segunda instancia del control. Comentarios El servidor puede decidir si acepta o no la conexión. Si no se acepta la conexión entrante, el equipo (cliente) obtendrá el evento Close. Utilice el método Accept (en una nueva instancia del control) para aceptar una conexión entrante. Ejemplo del método Accept, evento ConnectionRequest El ejemplo ilustra el código necesario para conectar un control Winsock mediante el protocolo TCP. El código se ejecuta en el equipo que acepta la solicitud de conexión. El parámetro RequestID identifica la solicitud. Ésta se pasa al método Accept, que acepta la solicitud en particular. Código: Private Sub WinsockTCP_ConnectionRequest _ (requestID As Long) If Winsock1.State <> sckClosed Then Winsock1.Close Winsock.Accept IdSolicitud End Sub DataArrival (Evento) Se produce cuando llegan nuevos datos. Sintaxis objeto_DataArrival (bytesTotales As Long) La sintaxis del evento DataArrival consta de las siguientes partes: Código: Parte Descripción objeto Objeto Winsock bytesTotales Long. Cantidad total de datos que se puede recuperar. Comentarios Este evento no se producirá si no recupera todos los datos con una llamada GetData. Sólo se activa cuando hay datos nuevos. Utilice la propiedad BytesReceived para comprobar la cantidad de datos disponibles en cualquier momento.

Ejemplo del método GetData (Control Winsock, evento DataArrival En este ejemplo se utiliza el método GetData del evento DataArrival de un control Winsock. Cuando se produce el evento, el código llama al método GetData para recuperar los datos y los almacena en una variable de cadena. Después se escriben los datos en un control TextBox. Código: Private Sub Winsock1_DataArrival _ (ByVal bytesTotales As Long) Dim strData As String Winsock1.GetData strData, vbString Text1.Text = Text1.Text & strData End Sub Error (Evento, control Winsock Control) Se produce siempre que ocurre un error en los procesos de segundo plano (por ejemplo, un fallo al conectar o un fallo al enviar o recibir en segundo plano). Sintaxis objeto_Error(número As Integer, descripción As String, scode As Long, origen As String, archivoAyuda as String, contextoAyuda As Long, cancelarVista As Boolean) La sintaxis del evento Error consta de las siguientes partes: Código: Parte Descripción objeto Control Winsock número Entero que define el código de error. Vea las constantes más abajo, en Valores. descripción Cadena que contiene la información del error. scode SCODE largo. origen Cadena que describe el origen del error. archivoAyuda Cadena que contiene el nombre del archivo de ayuda. contextoAyuda Contexto del archivo de ayuda. cancelarVista Indica si se cancelará la vista del mensaje de error. El valor predeterminado es False, que indica mostrar el cuadro de mensaje de error predeterminado. Si no desea usar el cuadro de mensaje predeterminado, establezca cancelarVista a True. Valores

Los valores de número son: Código: Constante Valor Descripción sckOutOfMemory 7 Sin memoria sckInvalidPropertyValue 380 El valor de la propiedad no es válido. sckGetNotSupported 394 No se puede leer la propiedad. sckSetNotSupported 383 La propiedad es de sólo lectura. sckBadState 40006 Protocolo o estado de conexión incorrecto para la solicitud o la transacción requerida. sckInvalidArg 40014 El argumento que se pasó a una función no estaba en el formato correcto o en el intervalo especificado. sckSuccess 40017 Correcto. sckUnsupported 40018 Tipo Variant no aceptado. sckInvalidOp 40020 La operación no es válida en el estado actual. sckOutOfRange 40021 El argumento está fuera del intervalo. sckWrongProtocol 40026 Protocolo erróneo para la solicitud o la transacción requerida. sckOpCanceled 10004 Se canceló la operación. sckInvalidArgument 10014 La dirección solicitada es una dirección de multidifusión, pero el indicador no está activado. sckWouldBlock 10035 El socket es no bloqueante y la operación especificada se bloqueará. sckInProgress 10036 Se está efectuando una operación de Winsock bloqueante. sckAlreadyComplete 10037 Se completó la operación. No se están efectuando operaciones bloqueantes. sckNotSocket 10038 El descriptor no es un socket. sckMsgTooBig 10040 El datagrama es demasiado grande para el búfer y se truncará. sckPortNotSupported 10043 El puerto especificado no es compatible. sckAddressInUse 10048 Dirección en uso. sckAddressNotAvailable 10049 La dirección no está disponible en la máquina local. sckNetworkSubsystemFailed 10050 Error en el subsistema de red. sckNetworkUnreachable 10051 El host no puede encontrar la red en este momento. sckNetReset 10052 Expiró el tiempo de espera de la conexión antes de establecer SO_KEEPALIVE. sckConnectAborted 10053 La conexión se ha cancelado al sobrepasar el tiempo de espera o por otro error. sckConnectionReset 10054 La conexión se ha restablecido desde el lado remoto. sckNoBufferSpace 10055 No hay espacio disponible en el búfer. sckAlreadyConnected 10056 El socket ya está conectado. sckNotConnected 10057 El socket no está conectado. sckSocketShutdown 10058 El socket se ha desactivado. sckTimedout 10060 Se ha sobrepasado el tiempo de conexión. sckConnectionRefused 10061 Se ha forzado el rechazo de la conexión. sckNotInitialized 10093 Es necesario llamar primero a WinsockInit.

sckHostNotFound 11001 Respuesta autorizada: host no encontrado. sckHostNotFoundTryAgain 11002 Respuesta no autorizada: host no encontrado. sckNonRecoverableError 11003 Errores no recuperables. sckNoData 11004 Nombre válido; no hay registro de datos del tipo solicitado. SendComplete (Evento) Se produce cuando termina una operación de envío. Sintaxis objeto_SendComplete Argumentos Ninguno SendProgress (Evento) Se produce mientras se están enviando datos. Sintaxis objeto_SendProgress (bytesEnv As Long, bytesRest As Long) La sintaxis del evento SendProgress consta de las siguientes partes: Código: Parte Descripción objeto Expresión de objeto que da como resultado un objeto de la lista Se aplica a. bytesEnv Número de bytes enviados desde la última vez que se activó el evento. bytesRest Número de bytes que esperan en el búfer de envío a ser enviados.