Socket::GetSocketOption Method (SocketOptionLevel, SocketOptionName, Int32)
Returns the value of the specified Socket option in an array.
Assembly: System (in System.dll)
public: array<unsigned char>^ GetSocketOption( SocketOptionLevel optionLevel, SocketOptionName optionName, int optionLength )
Parameters
- optionLevel
-
Type:
System.Net.Sockets::SocketOptionLevel
One of the SocketOptionLevel values.
- optionName
-
Type:
System.Net.Sockets::SocketOptionName
One of the SocketOptionName values.
- optionLength
-
Type:
System::Int32
The length, in bytes, of the expected return value.
Return Value
Type: array<System::Byte>^An array of type Byte that contains the value of the socket option.
| Exception | Condition |
|---|---|
| SocketException | An error occurred when attempting to access the socket. See the Remarks section for more information. - or - In .NET Compact Framework applications, the Windows CE default buffer space is set to 32768 bytes. You can change the per socket buffer space by calling SetSocketOption. |
| ObjectDisposedException | The Socket has been closed. |
The optionLength parameter sets the maximum size of the returned byte array. If the option value requires fewer bytes, the array will contain only that many bytes. If the option value requires more bytes, GetSocketOption will throw a SocketException. Use this overload for any sockets that are represented by Boolean values or integers.
Note |
|---|
If you receive a SocketException, use the SocketException::ErrorCode property to obtain the specific error code. After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation in the MSDN library for a detailed description of the error. |
Note |
|---|
This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing in the .NET Framework. |
The following code example retrieves the LingerOption and Send time-out values and displays them to the console.
Console::Write( "This application will timeout if Send does not return within " ); Console::WriteLine( Encoding::ASCII->GetString( s->GetSocketOption( SocketOptionLevel::Socket, SocketOptionName::SendTimeout, 4 ) ) ); // Blocks until send returns. int i = s->Send( msg ); // Blocks until read returns. array<Byte>^ bytes = gcnew array<Byte>(1024); s->Receive( bytes ); //Displays to the screen. Console::WriteLine( Encoding::ASCII->GetString( bytes ) ); s->Shutdown( SocketShutdown::Both ); Console::Write( "If data remains to be sent, this application will stay open for " ); Console::WriteLine( safe_cast<LingerOption^>(s->GetSocketOption( SocketOptionLevel::Socket, SocketOptionName::Linger ))->LingerTime.ToString() ); s->Close();
Available since 1.1
