CAsyncSocket::IOCtl

Articolo
03/05/2013

Chiamare la funzione membro per controllare la modalità di un socket.

BOOL IOCtl(
   long lCommand,
   DWORD* lpArgument 
);

Parametri

lCommand
Il comando da eseguire su socket.
lpArgument
Un puntatore a un parametro per lCommand.

Valore restituito

Diverso da zero se la funzione ha esito positivo; in caso contrario 0 e un codice di errore specifico possono essere recuperati chiamando GetLastError.Gli errori seguenti si applicano a questa funzione membro:

WSANOTINITIALISED Al AfxSocketInit deve verificarsi prima di utilizzare questa API.
WSAENETDOWN che l'implementazione di Windows Sockets ha rilevato che il sottosistema di rete non è riuscita.
WSAEINVAL lCommand non è un comando valido, o lpArgument non è un parametro accettabile per lCommand, o il comando non è applicabile al tipo di socket fornito.
WSAEINPROGRESS che blocca l'operazione di Windows Sockets è in corso.
WSAENOTSOCK il descrittore non è un socket.

Note

Questa procedura può essere utilizzata in un socket in uno stato.Viene utilizzata per ottenere o recuperare i parametri di esercizio associati a un socket, indipendente dal protocollo e il sottosistema di comunicazione.I seguenti controlli sono supportati:

FIONBIO abilita o disabilita la modalità non bloccante su socket.I punti lpArgument a DWORD, che è diverso da zero se la modalità non bloccante è possibile attivare e zero se deve essere disabilitata.Se AsyncSelect è stato pubblicato in un socket, il IOCtl utilizzare per impostare un socket alla modalità di blocco non riuscirà a WSAEINVAL.Per impostare un socket alla modalità di blocco e per impedire l'errore WSAEINVAL, un'applicazione deve innanzitutto disabilitare AsyncSelect chiamando AsyncSelect con il parametro lEvent uguale a 0, quindi chiama IOCtl.
FIONREAD determina il numero massimo di byte che possono essere letti a una chiamata Ricezione da questo socket.I punti lpArgument a DWORD in cui IOCtl archivia il risultato.Se questo socket è di tipo SOCK_STREAM, FIONREAD restituisce la quantità totale di dati che possono essere letti in un singolo Ricezione; generalmente corrisponde alla quantità totale di dati in coda su socket.Se questo socket è di tipo SOCK_DGRAM, FIONREAD restituisce le dimensioni del primo datagram accodata su socket.
SIOCATMARK determina se tutti i dati fuori banda letti.Si applica solo a un socket di tipo SOCK_STREAM configurato per ricevere inline di tutti i dati fuori banda (SO_OOBINLINE).Se nessun dati fuori banda è in attesa di essere letto, l'operazione restituisce diverso da zero.In caso contrario restituisce 0 e Ricezione successivo o ReceiveFrom eseguito su socket recupererà alcuni o tutti i dati che precede il "flag"; l'applicazione deve utilizzare l'operazione SIOCATMARK per determinare se i dati rimangano.Se esistono di dati standard che precedono i dati (fuori banda) "urgenti", verranno ricevuti in ordine.Notare che Ricezione o ReceiveFrom mai combinerà i dati fuori banda normali nella stessa chiamata.) I punti lpArgument a DWORD in cui IOCtl archivia il risultato.

Questa funzione è un sottoinsieme ioctl() utilizzati nei socket di Berkeley.In particolare, non esiste alcun comando che equivale a FIOASYNC, mentre SIOCATMARK è l'unico di comando livello di socket supportato.