send-Funktion (winsock2.h)

Die Send-Funktion sendet Daten auf einem verbundenen Socket.

Syntax

int WSAAPI send(
  [in] SOCKET     s,
  [in] const char *buf,
  [in] int        len,
  [in] int        flags
);

Parameter

[in] s

Ein Deskriptor, der einen verbundenen Socket identifiziert.

[in] buf

Ein Zeiger auf einen Puffer, der die zu übertragenden Daten enthält.

[in] len

Die Länge der Daten in Bytes, auf die der buf-Parameter im Puffer verweist.

[in] flags

Ein Satz von Flags, die die Art und Weise angeben, in der der Aufruf erfolgt. Dieser Parameter wird mithilfe des bitweisen OR-Operators mit einem der folgenden Werte erstellt.

Rückgabewert

Wenn kein Fehler auftritt, gibt send die Gesamtzahl der gesendeten Bytes zurück, die kleiner sein kann als die Anzahl, die im len-Parameter gesendet werden soll. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und ein bestimmter Fehlercode kann durch Aufrufen von WSAGetLastError abgerufen werden.

Hinweise

Die Send-Funktion wird verwendet, um ausgehende Daten in einen verbundenen Socket zu schreiben.

Bei nachrichtenorientierten Sockets (Adressfamilie von AF_INET oder AF_INET6, Typ der SOCK_DGRAM und Protokoll von IPPROTO_UDP z. B.) muss darauf geachtet werden, dass die maximale Paketgröße des zugrunde liegenden Anbieters nicht überschritten wird. Die maximale Nachrichtenpaketgröße für einen Anbieter kann durch Aufrufen von getsockopt abgerufen werden, wobei der Parameter optname auf SO_MAX_MSG_SIZE festgelegt ist, um den Wert der Socketoption abzurufen. Wenn die Daten zu lang sind, um sie atomar über das zugrunde liegende Protokoll zu übergeben, wird der Fehler WSAEMSGSIZE zurückgegeben, und es werden keine Daten übertragen.

Der erfolgreiche Abschluss einer Sendefunktion gibt nicht an, dass die Daten erfolgreich an den Empfänger übermittelt und empfangen wurden. Diese Funktion gibt nur an, dass die Daten erfolgreich gesendet wurden.

Wenn im Transportsystem kein Pufferspeicher zur Verfügung steht, um die zu übertragenden Daten aufzunehmen, wird send blockiert, es sei denn, der Socket wurde in den Nichtblockierungsmodus versetzt. Bei nicht blockierenden datenstromorientierten Sockets kann die Anzahl der geschriebenen Bytes zwischen 1 und der angeforderten Länge betragen, abhängig von der Pufferverfügbarkeit auf den Client- und Servercomputern. Die Funktionen select, WSAAsyncSelect oder WSAEventSelect können verwendet werden, um zu bestimmen, wann mehr Daten gesendet werden können.

Das Aufrufen von send mit dem len-Parameter null ist zulässig und wird von Implementierungen als erfolgreich behandelt. In solchen Fällen gibt send null als gültigen Wert zurück. Für nachrichtenorientierte Sockets wird ein Transportdatengramm der Länge Null gesendet.

Der Flags-Parameter kann verwendet werden, um das Verhalten der Funktion über die für den zugeordneten Socket angegebenen Optionen hinaus zu beeinflussen. Die Semantik der Send-Funktion wird durch alle Optionen bestimmt, die zuvor für den Socket festgelegt wurden, der im s-Parameter und im flags-Parameter festgelegt wurde, der an die send-Funktion übergeben wurde.

Die Reihenfolge der zu sendenden Aufrufe ist auch die Reihenfolge, in der die Puffer an die Transportschicht übertragen werden. Send sollte nicht gleichzeitig auf demselben streamorientierten Socket von verschiedenen Threads aufgerufen werden, da einige Winsock-Anbieter eine große Sendeanforderung in mehrere Übertragungen aufteilen können. Dies kann dazu führen, dass unbeabsichtigte Daten aus mehreren gleichzeitigen Sendeanforderungen auf demselben streamorientierten Socket überlappen.

Beispielcode

#ifndef UNICODE
#define UNICODE
#endif

#define WIN32_LEAN_AND_MEAN

#include <winsock2.h>
#include <Ws2tcpip.h>
#include <stdio.h>

// Link with ws2_32.lib
#pragma comment(lib, "Ws2_32.lib")

#define DEFAULT_BUFLEN 512
#define DEFAULT_PORT 27015

int main() {

    //----------------------
    // Declare and initialize variables.
    int iResult;
    WSADATA wsaData;

    SOCKET ConnectSocket = INVALID_SOCKET;
    struct sockaddr_in clientService; 

    int recvbuflen = DEFAULT_BUFLEN;
    char *sendbuf = "Client: sending data test";
    char recvbuf[DEFAULT_BUFLEN] = "";

    //----------------------
    // Initialize Winsock
    iResult = WSAStartup(MAKEWORD(2,2), &wsaData);
    if (iResult != NO_ERROR) {
        wprintf(L"WSAStartup failed with error: %d\n", iResult);
        return 1;
    }

    //----------------------
    // Create a SOCKET for connecting to server
    ConnectSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (ConnectSocket == INVALID_SOCKET) {
        wprintf(L"socket failed with error: %ld\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    //----------------------
    // The sockaddr_in structure specifies the address family,
    // IP address, and port of the server to be connected to.
    clientService.sin_family = AF_INET;
    clientService.sin_addr.s_addr = inet_addr( "127.0.0.1" );
    clientService.sin_port = htons( DEFAULT_PORT );

    //----------------------
    // Connect to server.
    iResult = connect( ConnectSocket, (SOCKADDR*) &clientService, sizeof(clientService) );
    if (iResult == SOCKET_ERROR) {
        wprintf(L"connect failed with error: %d\n", WSAGetLastError() );
        closesocket(ConnectSocket);
        WSACleanup();
        return 1;
  }

    //----------------------
    // Send an initial buffer
    iResult = send( ConnectSocket, sendbuf, (int)strlen(sendbuf), 0 );
    if (iResult == SOCKET_ERROR) {
        wprintf(L"send failed with error: %d\n", WSAGetLastError());
        closesocket(ConnectSocket);
        WSACleanup();
        return 1;
    }

    printf("Bytes Sent: %d\n", iResult);

    // shutdown the connection since no more data will be sent
    iResult = shutdown(ConnectSocket, SD_SEND);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"shutdown failed with error: %d\n", WSAGetLastError());
        closesocket(ConnectSocket);
        WSACleanup();
        return 1;
    }

    // Receive until the peer closes the connection
    do {

        iResult = recv(ConnectSocket, recvbuf, recvbuflen, 0);
        if ( iResult > 0 )
            wprintf(L"Bytes received: %d\n", iResult);
        else if ( iResult == 0 )
            wprintf(L"Connection closed\n");
        else
            wprintf(L"recv failed with error: %d\n", WSAGetLastError());

    } while( iResult > 0 );


    // close the socket
    iResult = closesocket(ConnectSocket);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"close failed with error: %d\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    WSACleanup();
    return 0;
}

Beispielcode

Hinweise zu IrDA-Sockets

• Die Headerdatei Af_irda.h muss explizit eingeschlossen werden.

Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

Anforderungen

Weitere Informationen

Erste Schritte mit Winsock

WSAAsyncSelect

WSAEventSelect

Winsock-Funktionen

Winsock-Referenz

Recv

recvfrom

select

Sendto

Socket