codice di controllo SIO_RCVALL

Articolo
06/13/2023

Descrizione

Il codice di controllo SIO_RCVALL consente a un socket di ricevere tutti i pacchetti IPv4 o IPv6 che passano attraverso un'interfaccia di rete.

Per eseguire questa operazione, chiamare la funzione WSAIoctl o WSPIoctl con i parametri seguenti.

int WSAIoctl(
  (socket) s,            // descriptor identifying a socket
  SIO_RCV_ALL,                       // dwIoControlCode
  NULL,                              // lpvInBuffer
  0,                                 // cbInBuffer
  NULL,                              // lpvOutBuffer output buffer
  (DWORD) cbOutBuffer,            // size of output buffer  
  (LPDWORD) lpcbBytesReturned,    // number of bytes returned
  (LPWSAOVERLAPPED) lpOverlapped, // OVERLAPPED structure
  (LPWSAOVERLAPPED_COMPLETION_ROUTINE) lpCompletionRoutine,  // completion routine
);

Parametri

s

Descrittore che identifica un socket.

dwIoControlCode

Codice di controllo per l'operazione. Usare SIO_RCVALL per questa operazione.

lpvInBuffer

Puntatore al buffer di input che deve contenere il valore dell'opzione. I valori possibili per l'opzione IOCTL SIO_RCVALL sono specificati nell'enumerazione RCVALL_VALUE definita nel file di intestazione Mstcpip.h .

I valori possibili per SIO_RCVALL sono i seguenti:

Valore	Significato
RCVALL_OFF	Disabilitare questa opzione in modo che un socket non riceva tutti i pacchetti IPv4 o IPv6 che passano attraverso un'interfaccia di rete.
RCVALL_ON	Abilitare questa opzione in modo che un socket riceva tutti i pacchetti IPv4 o IPv6 che passano attraverso un'interfaccia di rete. Questa opzione abilita la modalità promiscua nella scheda di interfaccia di rete (NIC), se la scheda di interfaccia di rete supporta la modalità promiscua. In un segmento LAN con un hub di rete, una scheda di interfaccia di rete che supporta la modalità promiscua acquisisce tutto il traffico IPv4 o IPv6 nella LAN, incluso il traffico tra altri computer nello stesso segmento LAN. Tutti i pacchetti acquisiti (IPv4 o IPv6, a seconda del socket) verranno recapitati al socket non elaborato. Questa opzione non acquisisce altri pacchetti (ARP, IPX e NetBEUI, ad esempio) nell'interfaccia. Netmon usa la stessa modalità per l'interfaccia di rete, ma non usa questa opzione per acquisire il traffico.
RCVALL_SOCKETLEVELONLY	Questa funzionalità non è attualmente implementata, quindi l'impostazione di questa opzione non ha alcun effetto.
RCVALL_IPLEVEL	Abilitare questa opzione in modo che un socket IPv4 o IPv6 riceva tutti i pacchetti a livello IP passando attraverso un'interfaccia di rete. Questa opzione non abilita la modalità promiscua nella scheda di interfaccia di rete. Questa opzione influisce solo sull'elaborazione dei pacchetti a livello IP. La scheda di interfaccia di rete riceve ancora solo pacchetti indirizzati ai relativi indirizzi unicast e multicast configurati. Tuttavia, un socket con questa opzione abilitato riceverà non solo pacchetti indirizzati a indirizzi IP specifici, ma riceverà tutti i pacchetti IPv4 o IPv6 ricevuti dalla scheda di interfaccia di rete. Questa opzione non acquisisce altri pacchetti (ARP, IPX e NetBEUI, ad esempio) ricevuti nell'interfaccia.

cbInBuffer

Dimensioni, in byte, del buffer di input. Questo parametro deve essere uguale o maggiore delle dimensioni del valore di enumerazione RCVALL_VALUE puntato dal parametro lpvInBuffer .

lpvOutBuffer

Puntatore al buffer di output. Questo parametro non viene usato per questa operazione.

cbOutBuffer

Dimensioni, in byte, del buffer di output. Questo parametro non viene usato per questa operazione.

lpcbBytesReturned

Puntatore a una variabile che riceve le dimensioni, in byte, dei dati archiviati nel buffer di output. Questo parametro non viene usato per questa operazione.

lpvOverlapped

Puntatore a una struttura WSAOVERLAPPED .

Se il socket s è stato creato senza l'attributo sovrapposto, il parametro lpOverlapped viene ignorato .

Se s è stato aperto con l'attributo sovrapposto e il parametro lpOverlapped non è NULL, l'operazione viene eseguita come operazione sovrapposta (asincrona). In questo caso, il parametro lpOverlapped deve puntare a una struttura WSAOVERLAPPED valida.

Per le operazioni sovrapposte, la funzione WSAIoctl o WSPIoctl restituisce immediatamente e il metodo di completamento appropriato viene segnalato al termine dell'operazione. In caso contrario, la funzione non restituisce finché l'operazione non è stata completata o si verifica un errore.

lpCompletionRoutine

Tipo: _In_opt_ LPWSAOVERLAPPED_COMPLETION_ROUTINE

Puntatore alla routine di completamento chiamata quando l'operazione è stata completata (ignorata per socket non sovrapposti).

lpThreadId

Puntatore a una struttura WSATHREADID da usare dal provider in una chiamata successiva a WPUQueueApc. Il provider deve archiviare la struttura WSATHREADID a cui fa riferimento (non lo stesso puntatore) fino a quando la funzione WPUQueueApc restituisce.

Nota Questo parametro si applica solo alla funzione WSPIoctl .

lpErrno

Puntatore al codice di errore.

Nota Questo parametro si applica solo alla funzione WSPIoctl .

Valore restituito

Se l'operazione viene completata correttamente, la funzione WSAIoctl o WSPIoctl restituisce zero.

Se l'operazione ha esito negativo o è in sospeso, la funzione WSAIoctl o WSPIoctl restituisce SOCKET_ERROR. Per ottenere informazioni sull'errore estese, chiamare WSAGetLastError.

Codice di errore	Significato
WSA_IO_PENDING	Un'operazione sovrapposta è stata avviata correttamente e il completamento verrà indicato in un secondo momento.
WSA_OPERATION_ABORTED	Un'operazione sovrapposta è stata annullata a causa della chiusura del socket o dell'esecuzione del comando IOCTL SIO_FLUSH .
WSAEFAULT	Il parametro lpOverlapped o lpCompletionRoutine non è totalmente contenuto in una parte valida dello spazio degli indirizzi utente.
WSAEINPROGRESS	La funzione viene richiamata quando un callback è in corso.
WSAEINTR	Un'operazione di blocco è stata interrotta.
WSAEINVAL	Il parametro dwIoControlCode non è un comando valido o un parametro di input specificato non è accettabile oppure il comando non è applicabile al tipo di socket specificato. Questo errore viene restituito anche se il parametro cbInBuffer è minore del `sizeof(UCHAR)` parametro o il parametro lpvInBuffer punta al valore che non è un valore di enumerazione RCVALL_VALUE . Questo errore può essere restituito anche se non è possibile trovare l'interfaccia di rete associata al socket. Ciò può verificarsi se l'interfaccia di rete associata al socket viene eliminata o rimossa (ad esempio, un dispositivo di rete PCMCIA o USB).
WSAENETDOWN	Il sottosistema di rete non è riuscito.
WSAENOBUFS	Nessun spazio buffer disponibile.
WSAENOPROTOOPT	L'opzione socket non è supportata nel protocollo specificato.
WSAENOTSOCK	Il descrittore s non è un socket.
WSAEOPNOTSUPP	Il comando IOCTL specificato non è supportato. Questo errore viene restituito se il SIO_RCVALL IOCTL non è supportato dal provider di trasporto.

Commenti

Il SIO_RCVALL IOCTL è supportato in Windows 2000 e versioni successive del sistema operativo.

Il SIO_RCVALL IOCTL consente a un socket di ricevere tutti i pacchetti IPv4 o IPv6 in un'interfaccia di rete. L'handle socket passato alla funzione WSAIoctl o WSPIoctl deve essere uno dei seguenti:

Socket IPv4 creato con la famiglia di indirizzi impostata su AF_INET, il tipo di socket impostato su SOCK_RAW e il protocollo impostato su IPPROTO_IP.
Socket IPv6 creato con la famiglia di indirizzi impostata su AF_INET6, tipo di socket impostato su SOCK_RAW e protocollo impostato su IPPROTO_IPV6.

Per altre informazioni sui socket non elaborati, vedere Socket non elaborati TCP/IP.

Il socket deve anche essere associato a un'interfaccia IPv4 o IPv6 locale esplicita, il che significa che non è possibile eseguire l'associazione a INADDR_ANY o in6addr_any.

Una volta che il socket è associato e L'IOCTL viene completato correttamente, le chiamate alle funzioni WSARecv o recv restituiscono datagrammi IPv4 che passano attraverso l'interfaccia IPv4 specificata o restituiscono datagrammi IPv6 passando attraverso l'interfaccia IPv6 specificata. Si noti che è necessario fornire un buffer sufficientemente grande. L'impostazione di questo IOCTL acquisisce solo i pacchetti IPv4 o IPv6 in una determinata interfaccia. Questo IOCTL non acquisirà altri pacchetti (pacchetti ARP, IPX e NetBEUI, ad esempio) nell'interfaccia.

Un socket associato a un'interfaccia locale specifica con il SIO_RCVALL IOCTL riceverà solo pacchetti che passano attraverso tale interfaccia. Non riceverà pacchetti ricevuti su un'altra interfaccia e verrà inoltrato su un'altra interfaccia diversa dal socket associato a SIO_RCVALL IOCTL.

In Windows Server 2008 e versioni precedenti, l'impostazione SIO_RCVALL IOCTL non acquisisce i pacchetti locali inviati da un'interfaccia di rete. Inclusi i pacchetti ricevuti in un'altra interfaccia e inoltrato l'interfaccia di rete specificata per il SIO_RCVALL IOCTL.

In Windows 7 e Windows Server 2008 R2 questo è stato modificato in modo che vengano acquisiti anche i pacchetti locali inviati da un'interfaccia di rete. Sono inclusi i pacchetti ricevuti in un'altra interfaccia e quindi inoltrata l'interfaccia di rete associata al socket con SIO_RCVALL IOCTL.

L'impostazione di questo IOCTL richiede privilegi di amministratore nel computer locale.

Questa funzionalità viene talvolta definita modalità promiscua. Qualsiasi modifica diretta rispetto all'applicazione di questa opzione in un'interfaccia e quindi a un'altra con una singola chiamata che usa questo IOCTL non è supportata. Un'applicazione deve prima usare questo IOCTL per disattivare il comportamento nella prima interfaccia e quindi usare questo IOCTL per abilitare il comportamento in una nuova interfaccia.