Socket.IOControl Método

  • Referência

Definição

Namespace:
System.Net.Sockets
Assembly:
System.Net.Sockets.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Define os modos de operação de nível baixo para o Socket.

Sobrecargas

IOControl(Int32, Byte[], Byte[])

Define os modos de operação de nível inferior do Socket usando códigos de controle numéricos.
IOControl(IOControlCode, Byte[], Byte[])

Define modos de operação de nível inferior do Socket usando a enumeração IOControlCode para especificar códigos de controle.

IOControl(Int32, Byte[], Byte[])

Define os modos de operação de nível inferior do Socket usando códigos de controle numéricos.

public:
 int IOControl(int ioControlCode, cli::array <System::Byte> ^ optionInValue, cli::array <System::Byte> ^ optionOutValue);
public int IOControl (int ioControlCode, byte[]? optionInValue, byte[]? optionOutValue);
public int IOControl (int ioControlCode, byte[] optionInValue, byte[] optionOutValue);
member this.IOControl : int * byte[] * byte[] -> int
Public Function IOControl (ioControlCode As Integer, optionInValue As Byte(), optionOutValue As Byte()) As Integer

Parâmetros

ioControlCode
Int32

Um valor Int32 que especifica o código de controle da operação a ser executado.

optionInValue
Byte[]

Uma matriz Byte que contém os dados de entrada necessários para a operação.

optionOutValue
Byte[]

Uma matriz Byte que contém os dados de saída retornados para a operação.

Retornos

Int32

O número de bytes no parâmetro optionOutValue.

Exceções

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

InvalidOperationException

Foi feita uma tentativa de alterar o modo de bloqueio sem usar a propriedade Blocking.

SecurityException

Um chamador na pilha de chamadas não tem as permissões necessárias.

Exemplos

O exemplo de código a seguir compara os resultados de FIONREAD e da propriedade Available.

// FIONREAD is also available as the "Available" property.
const int FIONREAD = 0x4004667F;

void DisplayPendingByteCount( Socket^ s )
{
   array<Byte>^ outValue = BitConverter::GetBytes( 0 );
   
   // Check how many bytes have been received.
   s->IOControl( FIONREAD, nullptr, outValue );

   UInt32 bytesAvailable = BitConverter::ToUInt32( outValue, 0 );
   Console::WriteLine( "server has {0} bytes pending. Available property says {1}.",
      bytesAvailable, s->Available );

   return;
}

 // FIONREAD is also available as the "Available" property.
public const int FIONREAD   = 0x4004667F;

static void DisplayPendingByteCount(Socket s)
 {
     byte[] outValue = BitConverter.GetBytes(0);

     // Check how many bytes have been received.
     s.IOControl(FIONREAD, null, outValue);

     uint bytesAvailable = BitConverter.ToUInt32(outValue, 0);
     Console.WriteLine("server has {0} bytes pending. Available property says {1}.",
         bytesAvailable, s.Available);

     return;
 }

Comentários

O IOControl método fornece acesso de baixo nível ao sistema Socket operacional subjacente à instância atual da Socket classe. Para obter mais informações, consulte a documentação do WSAIoctl .

Observação

Se você receber um SocketException, use a SocketException.ErrorCode propriedade para obter o código de erro específico. Depois de obter esse código, consulte a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

Aplica-se a

IOControl(IOControlCode, Byte[], Byte[])

Define modos de operação de nível inferior do Socket usando a enumeração IOControlCode para especificar códigos de controle.

public:
 int IOControl(System::Net::Sockets::IOControlCode ioControlCode, cli::array <System::Byte> ^ optionInValue, cli::array <System::Byte> ^ optionOutValue);
public int IOControl (System.Net.Sockets.IOControlCode ioControlCode, byte[]? optionInValue, byte[]? optionOutValue);
public int IOControl (System.Net.Sockets.IOControlCode ioControlCode, byte[] optionInValue, byte[] optionOutValue);
member this.IOControl : System.Net.Sockets.IOControlCode * byte[] * byte[] -> int
Public Function IOControl (ioControlCode As IOControlCode, optionInValue As Byte(), optionOutValue As Byte()) As Integer

Parâmetros

ioControlCode
IOControlCode

Um valor IOControlCode que especifica o código de controle da operação a ser executada.

optionInValue
Byte[]

Uma matriz do tipo Byte que contém os dados de entrada necessários para a operação.

optionOutValue
Byte[]

Uma matriz do tipo Byte que contém os dados de saída retornados pela operação.

Retornos

Int32

O número de bytes no parâmetro optionOutValue.

Exceções

SocketException

Ocorreu um erro ao tentar acessar o soquete.

ObjectDisposedException

O Socket foi fechado.

InvalidOperationException

Foi feita uma tentativa de alterar o modo de bloqueio sem usar a propriedade Blocking.

Exemplos

O exemplo de código a seguir compara os resultados da chamada IOControl com DataToRead a Available propriedade.

void DisplayPendingByteCount( Socket^ s )
{
   array<Byte>^ outValue = BitConverter::GetBytes( 0 );
   
   // Check how many bytes have been received.
   s->IOControl( IOControlCode::DataToRead, nullptr, outValue );

   UInt32 bytesAvailable = BitConverter::ToUInt32( outValue, 0 );
   Console::Write( "server has {0} bytes pending,",
      bytesAvailable );
   Console::WriteLine( "Available property says {1}.",
      s->Available );
   return;
}

static void DisplayPendingByteCount(Socket s)
{
    byte[] outValue = BitConverter.GetBytes(0);

    // Check how many bytes have been received.
    s.IOControl(IOControlCode.DataToRead, null, outValue);

    uint bytesAvailable = BitConverter.ToUInt32(outValue, 0);
    Console.Write("server has {0} bytes pending. ",
        bytesAvailable);
    Console.WriteLine("Available property says {1}.",
                     s.Available);

    return;
}

Comentários

Esse método fornece acesso de baixo nível ao sistema Socket operacional subjacente à instância atual da Socket classe. Para obter mais informações, consulte a documentação do WSAIoctl .

Observação

Se você receber um SocketException, use a SocketException.ErrorCode propriedade para obter o código de erro específico. Depois de obter esse código, consulte a documentação do código de erro da API do Windows Sockets versão 2 para obter uma descrição detalhada do erro.

Observação

Esse membro emite o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo. Para obter mais informações, consulte Rastreamento de Rede no .NET Framework.

Aplica-se a