|
|
| SOCKET
InetConnect(
|
|
|
LPCTSTR
lpszHostName, |
|
|
|
UINT nPort, |
|
|
|
UINT nProtocol, |
|
|
|
UINT nTimeout |
|
| );
|
Parameters
- lpszHostName
- A pointer to the name of the remote host to connect to; this
may be a fully-qualified domain name, or an IP address.
- nPort
- The port number the remote server is listening on. This value
must be greater than zero.
- nProtocol
- The protocol to be used when establishing the connection. This
may be one of the following values:
| Constant |
Description |
|
INET_PROTOCOL_TCP |
Specifies the Transmission Control Protocol.
This protocol provides a reliable, bi-directional byte stream. This
is the default protocol. |
|
INET_PROTOCOL_UDP |
Specifies the User Datagram Protocol. This
protocol is message oriented, sending data in discrete packets.
Note that UDP is unreliable in that there is no way for the sender
to know that the receiver has actually received the datagram. |
- nTimeout
- The number of seconds to wait for the connection to complete
before failing the operation; a value of zero indicates that the
current thread should wait an indefinite period of time.
Return Value
If the function succeeds, the return value is a handle to a
socket. If the function fails, the return value is INVALID_SOCKET.
To get extended error information, call
InetGetLastError.
Remarks
When this function is called with UDP as the specified protocol,
it does not actually establish a connection. Instead, it simply
establishes a default destination IP address and port that is used
with subsequent InetRead and InetWrite calls.
To enable asynchronous event notification, use the
InetEnableEvents function.
Requirements
Client: Requires Windows Vista, Windows XP or Windows
2000 Professional.
Server: Requires Windows Server 2008, Windows Server 2003 or
Windows 2000 Server.
Header: Include cswsock6.h.
Library: Use cswskav6.lib.
Unicode: Implemented as Unicode and ANSI versions.
See Also
InetAsyncConnect, InetAsyncConnectEx, InetConnectEx, InetDisableEvents, InetDisconnect, InetEnableEvents, InetInitialize, InetRead, InetWrite
|
|