función shutdown (winsock.h)

La función de apagado deshabilita los envíos o las recibe en un socket.

Sintaxis

int shutdown(
  [in] SOCKET s,
  [in] int    how
);

Parámetros

[in] s

Descriptor que identifica un socket.

[in] how

Marca que describe qué tipos de operación ya no se permitirán. Los valores posibles para esta marca se muestran en el archivo de encabezado Winsock2.h .

Valor devuelto

Si no se produce ningún error, el apagado devuelve cero. De lo contrario, se devuelve un valor de SOCKET_ERROR y se puede recuperar un código de error específico llamando a WSAGetLastError.

Comentarios

La función de apagado se usa en todos los tipos de sockets para deshabilitar la recepción, transmisión o ambos.

Si el parámetro how es SD_RECEIVE, no se permitirán las llamadas posteriores a la función recv en el socket. Esto no tiene ningún efecto en las capas de protocolo inferiores. En el caso de los sockets TCP, si todavía hay datos en cola en el socket que esperan recibirse, o los datos llegan posteriormente, se restablece la conexión, ya que los datos no se pueden entregar al usuario. En el caso de los sockets UDP, se aceptan y ponen en cola los datagramas entrantes. En ningún caso se generará un paquete de error ICMP.

Si el parámetro how es SD_SEND, no se permiten las llamadas posteriores a la función de envío . En el caso de los sockets TCP, el receptor enviará una fin después de que el receptor envíe y confirme todos los datos.

Establecer cómo SD_BOTH deshabilita los envíos y los recibe como se ha descrito anteriormente.

La función shutdown no cierra el socket. Los recursos conectados al socket no se liberarán hasta que se invoque closesocket .

Para asegurarse de que todos los datos se envían y reciben en un socket conectado antes de cerrarse, una aplicación debe usar el apagado para cerrar la conexión antes de llamar a Closesocket. Un método para esperar una notificación de que el extremo remoto ha enviado todos sus datos e iniciado una desconexión correcta usa la función WSAEventSelect como se indica a continuación:

1. Llame a WSAEventSelect para registrarse para FD_CLOSE notificación.
2. Llame al apagado con how=SD_SEND.
3. Cuando FD_CLOSE recibido, llame a la recv o WSARecv hasta que la función se complete correctamente e indique que se recibieron cero bytes. Si se devuelve SOCKET_ERROR, la desconexión correcta no es posible.
4. Llame a closesocket.

1. Llame al apagado con how=SD_SEND.
2. Llame a recv o WSARecv hasta que la función se complete correctamente e indique que se recibieron cero bytes. Si se devuelve SOCKET_ERROR, la desconexión correcta no es posible.
3. Llame a closesocket.

Para obtener más información, vea la sección sobre Cierre correcto, Opciones de persistencia y Cierre de sockets.

Una vez que se llama a la función de apagado para deshabilitar el envío, la recepción o ambos, no hay ningún método para volver a habilitar el envío o la recepción de la conexión de socket existente.

Una aplicación no debe depender de poder reutilizar un socket después de que este se haya apagado. En concreto, no se requiere un proveedor de Windows Sockets para admitir el uso de la conexión en un socket que se ha apagado.

Si una aplicación desea reutilizar un socket, se debe llamar a la función DisconnectEx con el parámetro dwFlags establecido en TF_REUSE_SOCKET para cerrar una conexión en un socket y preparar el identificador de socket que se va a reutilizar. Cuando se completa la solicitud DisconnectEx , el identificador de socket se puede pasar a la función AcceptEx o ConnectEx .

Si una aplicación quiere reutilizar un socket, se puede llamar a las funciones TransmitFile o TransmitPackets con el parámetro dwFlags establecido con TF_DISCONNECT y TF_REUSE_SOCKET para desconectar después de que todos los datos se hayan puesto en cola para la transmisión y preparen el identificador de socket que se va a reutilizar. Cuando se completa la solicitud TransmitFile , el identificador de socket se puede pasar a la llamada de función usada anteriormente para establecer la conexión, como AcceptEx o ConnectEx. Cuando se completa la función TransmitPackets , el identificador de socket se puede pasar a la función AcceptEx .

Notas para ATM

Windows Phone 8: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.

Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

Consulte también

AcceptEx

ConnectEx

DisconnectEx

TransmitFile

TransmitPackets

WSAEventSelect

Funciones winsock

Referencia de Winsock

connect

socket