SourcePro® API Reference Guide

 
List of all members | Public Member Functions
RWWinSockInfo Class Reference

Initializes the Winsock DLL on Windows platforms. More...

#include <rw/network/RWWinSockInfo.h>

Public Member Functions

 RWWinSockInfo (short ver=0x0202)
 
 RWWinSockInfo (FARPROC blockingHook)
 
 ~RWWinSockInfo (void)
 
RWCString getDescription (void) const
 
int getMajorVersion (void) const
 
int getMinorVersion (void) const
 

Detailed Description

Initializes the Winsock DLL on Windows platforms. Initialization is required before your application can make requests of the Winsock API. Deregistration is required for applications that no longer need Winsock services.

Rogue Wave encourages all users to include this class in their code. While using this class does not affect the behavior of programs that run on UNIX, it does make them portable to Windows environments.

Note
If you use Winsock.dll in a DLL, either directly or indirectly, you must initialize it. The fastest way to do this may be to create an instance of RWWinSockInfo in DllMain().

Constructor & Destructor Documentation

RWWinSockInfo::RWWinSockInfo ( short  ver = 0x0202)

Initializes the underlying socket API with the requested version. If the Winsock DLL has already been initialized by this application, the constructor does nothing. An exception of type RWNetWinsockInitError is thrown if the initialization fails. This function is a no-op on non Windows platforms.

RWWinSockInfo::~RWWinSockInfo ( void  )

Performs the termination tasks.

RWWinSockInfo::RWWinSockInfo ( FARPROC  blockingHook)
Deprecated:
As of SourcePro 4. Blocking hooks are no longer supported by the Windows Socket 2 API.

Initializes the Winsock DLL and installs the blocking hook indicated. The previous blocking hook is restored when the RWWinSockInfo is destroyed.

Condition:
Available only on the Windows platform.

Member Function Documentation

RWCString RWWinSockInfo::getDescription ( void  ) const

Returns the vendor-supplied description of the Winsock DLL. The string "not winsock" is returned on platforms that do not support winsock.

int RWWinSockInfo::getMajorVersion ( void  ) const

Returns the vendor-supplied major version of the Winsock DLL. Returns 0 on platforms that do not support Winsock.

int RWWinSockInfo::getMinorVersion ( void  ) const

Returns the vendor-supplied minor version of the Winsock DLL. Returns 0 on platforms that do not support Winsock.

Copyright © 2023 Rogue Wave Software, Inc., a Perforce company. All Rights Reserved.