TAPI编程

开发平台：
Visual C++

curl_easy_send.3：源码内容
							." **************************************************************************
." *                                  _   _ ____  _
." *  Project                     ___| | | |  _ | |
." *                             / __| | | | |_) | |
." *                            | (__| |_| |  _ <| |___
." *                             ___|___/|_| ______|
." *
." * Copyright (C) 1998 - 2008, Daniel Stenberg, <daniel@haxx.se>, et al.
." *
." * This software is licensed as described in the file COPYING, which
." * you should have received as part of this distribution. The terms
." * are also available at http://curl.haxx.se/docs/copyright.html.
." *
." * You may opt to use, copy, modify, merge, publish, distribute and/or sell
." * copies of the Software, and permit persons to whom the Software is
." * furnished to do so, under the terms of the COPYING file.
." *
." * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
." * KIND, either express or implied.
." *
." * $Id: curl_easy_send.3,v 1.1 2008-05-12 21:43:28 bagder Exp $
." **************************************************************************
."
.TH curl_easy_send 3 "29 April 2008" "libcurl 7.18.2" "libcurl Manual"
.SH NAME
curl_easy_send - sends raw data over an "easy" connection 
.SH SYNOPSIS
.B #include <curl/easy.h>
.sp
.BI "CURLcode curl_easy_send( CURL *" curl ", const void *" buffer ","
.BI " size_t " buflen ", size_t *" n ");"
.ad
.SH DESCRIPTION
This function sends arbitrary data over the established connection. You may
use it together with fIcurl_easy_recv(3)fP to implement custom protocols
using libcurl. This functionality can be particularly useful if you use
proxies and/or SSL encryption: libcurl will take care of proxy negotiation and
connection set-up.
fBbufferfP is a pointer to the data of length fBbuflenfP that you want sent.
The variable fBnfP points to will receive the number of sent bytes.
To establish the connection, set fBCURLOPT_CONNECT_ONLYfP option before
calling fIcurl_easy_perform(3)fP. Note that fIcurl_easy_send(3)fP will not
work on connections that were created without this option.
You must ensure that the socket is writable before calling
fIcurl_easy_send(3)fP, otherwise the call will return fBCURLE_AGAINfP -
the socket is used in non-blocking mode internally. Use
fIcurl_easy_getinfo(3)fP with fBCURLINFO_LASTSOCKETfP to obtain the
socket; use your operating system facilities like fIselect(2)fP to check if
it can be written to.
.SH AVAILABILITY
Added in 7.18.2.
.SH RETURN VALUE
On success, returns fBCURLE_OKfP and stores the number of bytes actually
sent into fB*nfP. Note that this may very well be less than the amount you
wanted to send.
On failure, returns the appropriate error code.
.SH EXAMPLE
See fBsendrecv.cfP in fBdocs/examplesfP directory for usage example.
.SH "SEE ALSO"
.BR curl_easy_setopt "(3), " curl_easy_perform "(3), " curl_easy_getinfo "(3), "
.BR curl_easy_recv "(3) "

						