CAsyncSocket::SendTo

int SendTo ( const void * lpBuf, int nBufLen, UINT nHostPort, LPCTSTR lpszHostAddress = NULL, int nFlags = 0 );

int SendTo ( const void * lpBuf, int nBufLen, const SOCKADDR * lpSockAddr, int nSockAddrLen, int nFlags = 0 );

Valore restituito

Se si verifica alcun errore, SendTo restituisce il numero totale di caratteri inviati. (Si noti che questo può essere inferiore al numero indicato dal nBufLen). In caso contrario, viene restituito un valore di SOCKET_ERROR , e un codice di errore specifico può essere recuperato chiamando GetLastError. I seguenti errori si applicano a questa funzione membro:

• WSA&NOTINITIALISEDnbsp;  Un successo AfxSocketInit deve avvenire prima di utilizzare questa API.
  
  
• WSAE&NETDOWNnbsp;  L'implementazione di Windows Sockets rilevato che non è riuscito il sottosistema di rete.
  
  
• WSAEACCES   L'indirizzo richiesto è un indirizzo di broadcast, ma non è stato impostato il flag appropriato.
  
  
• WSAEI&NPROGRESSnbsp;  Un'operazione di blocco Windows Sockets è in corso.
  
  
• WSAEFAULT   I parametri lpBuf o lpSockAddr non sono parte dello spazio degli indirizzi utente, o l'argomento lpSockAddr è troppo piccolo (inferiore alle dimensioni di una struttura SOCKADDR ).
  
  
• WSAEI&NVALnbsp;  Il nome host non è valido.
  
  
• WSAE&NETRESETnbsp;  La connessione deve essere reimpostata perché è sceso l'implementazione di Windows Sockets.
  
  
• WSAE&NOBUFSnbsp;  L'implementazione di Windows Sockets segnala un deadlock tampone.
  
  
• WSAE&NOTCONNnbsp;  La presa non è collegato (soloSOCK_STREAM ).
  
  
• WSAE&NOTSOCKnbsp;  Il descrittore non è una presa di corrente.
  
  
• WSAEOP&NOTSUPPnbsp;MSG_OOB è stata specificata, ma la presa non è di tipo SOCK_STREAM.
  
  
• WSAESHUTDOW&Nnbsp;  Il socket è stato chiuso; non è possibile chiamare SendTo su un socket, dopo l'arresto è stata invocata con nHow impostato su 1 o 2.
  
  
• WSAEWOULDBLOCK   Il socket è contrassegnato come non bloccante e bloccherebbe l'operazione richiesta.
  
  
• WSAEMSGSIZE   Il socket è di tipo SOCK_DGRAM, e il datagramma è superiore al massimo supportato dall'implementazione Windows Sockets.
  
  
• WSAECO&NNABORTEDnbsp;  Il circuito virtuale è stata interrotta a causa di timeout o altro errore.
  
  
• WSAECO&NNRESETnbsp;  Il circuito virtuale è stato ripristinato dal lato remoto.
  
  
• WSAEADDR&NOTAVAILnbsp;  L'indirizzo specificato non è disponibile dal computer locale.
  
  
• WSAEAF&NOSUPPORTnbsp;  Gli indirizzi della famiglia specificato non possono essere utilizzati con questo socket.
  
  
• WSAEDESTADDRREQ   Un indirizzo di destinazione è necessario.
  
  
• WSAE&NETUNREACHnbsp;  La rete non può essere raggiunto da questo host in questo momento.

Parametri

lpBuf

Un buffer contenente i dati da trasmettere.

nBufLen

La lunghezza dei dati di lpBuf in byte.

nHostPort

Il porto di identificare l'applicazione di presa.

lpszHostAddress

L'indirizzo di rete del socket a cui è collegato questo oggetto: un nome macchina come "ftp.microsoft.com" o un numero con punti, come "128.56.22.8".

nFlags

Specifica il modo in cui viene effettuata la chiamata. La semantica di questa funzione è determinata dalle opzioni del socket e il parametro nFlags . Quest'ultimo viene creato combinando uno qualsiasi dei seguenti valori con l'operatore C++ o:

• MSG_DO&NTROUTEnbsp;  Specifica che i dati non dovrebbero essere soggetta al routing. Un fornitore di Windows Sockets può scegliere di ignorare questa bandiera; vedi anche la discussione dell'opzione SO_DONTROUTE Windows Sockets programmazione considerazioni nella documentazione SDK Win32.
  
  
• MSG_OOB   Inviare dati out-of-band (soloSOCK_STREAM ).

lpSockAddr

Un puntatore a una struttura SOCKADDR che contiene l'indirizzo del socket destinazione.

nSockAddrLen

La lunghezza dell'indirizzo in lpSockAddr in byte.

Osservazioni

Chiamare questa funzione membro per inviare dati a una destinazione specifica. SendTo viene utilizzato su socket di datagramma o stream e viene utilizzato per scrivere dati in uscita su un socket. Per i socket di datagramma, deve prestare attenzione non deve superare la dimensione massima IP packet le subnet sottostante, che è dato dall'elemento nella struttura WSADATA compilata da AfxSocketInit iMaxUdpDg . Se i dati sono troppo lunghi atomicamente passare attraverso il protocollo sottostante, viene restituito l'errore WSAEMSGSIZE e nessun dato viene trasmessa.

Si noti che il completamento di un SendTo non indica che è stati recapitati correttamente i dati.

SendTo viene utilizzato solo su un socket SOCK_DGRAM per inviare un datagramma su un socket specifico identificato dal parametro lpSockAddr.

Per inviare una trasmissione (su un SOCK_DGRAM ), l'indirizzo nel parametro lpSockAddr dovrebbe essere costruito usando l'indirizzo IP speciale INADDR_BROADCAST (definito nel file di intestazione Windows Sockets WINSOCK.H) insieme con il numero della porta di destinazione. Oppure, se il parametro lpszHostAddress è NULL, il socket è configurato per il broadcast. Esso è generalmente sconsigliabile per un datagramma broadcast da superare la dimensione in cui può verificarsi la frammentazione, che implica che la parte di dati del datagramma (escluse le intestazioni) non superi i 512 byte.

CAsyncSocket panoramica |nbsp; Membri della classe | Gerarchia Chart

Vedere a&nchenbsp;CAsyncSocket::Create, CAsyncSocket::Receive, CAsyncSocket::ReceiveFrom, CAsyncSocket::Send