HttpSendRequest,Windows WinINet系列API函式之一,该函式用于传送HTTP请求到指定的伺服器。
基本介绍
- 外文名:HttpSendRequest
- 类型:API函式
- 用途:传送HTTP请求到指定的伺服器
- 返回值:TRUE/FALSE
简述
此函式传送HTTP请求到指定的伺服器。
语法
BOOL WINAPI HttpSendRequest( HINTERNET hRequest, LPCTSTR lpszHeaders, DWORD dwHeadersLength, LPVOID lpOptional, DWORD dwOptionalLength );
参数
参数
描述
hRequest
[]打开HTTP请求返回的句柄。
lpszHeaders
[]长指针以null结尾的字元串,包含额外的头被追加到请求。 此参数可以为NULL,如果没有额外的头追加。 请参阅备注
dwHeadersLength
[in]指定的长度,字元,额外的标头。 如果这个参数是-1L和lpszHeaders不为NULL,则该函式假定的lpszHeaders零结尾(ASCIIZ),计算长度。 请参阅备注
lpOptional
[]任何可选的数据传送后,立即请求头指针。 该参数通常用于POST和PUT操作。 可选的数据可以被传送到伺服器的资源或信息。 如果没有可选的数据传送,此参数可以为NULL。
dwOptionalLength
[in]指定选购的数据的长度,以位元组为单位。 如果没有可选的数据要传送时,这个参数可以是零。
返回值
TRUE表示成功。 FALSE表示失败。 可调用GetLastError函式,得到错误信息。
备注
这个函式有两个版本使用HttpSendRequestA ANSI版本和Unicode版本一起使用HttpSendRequestW。 如果该值dwHeadersLength-1L和lpszHeaders的值不为NULL,被称为HttpSendRequestA时,该函式假定lpszHeaders零结尾(ASCIIZ),计算长度。 当HttpSendRequestW这些值,调用函式将失败,ERROR_INVALID_PARAMETER。
此功能的HTTP伺服器传送指定的请求,并允许客户端指定另外的头与请求一起传送。
该功能还可以让客户端指定可选的数据传送到HTTP伺服器请求头紧随。 该特徵通常用于“写”操作,如PUT和POST。
传送请求后,从HTTP伺服器的状态代码和回响报头被读取。 这些头在内部进行维护,并提供给客户端应用程式通过HttpQueryInfo功能。
应用程式可以使用相同的HTTP请求句柄多次调用HttpSendRequest ,但应用程式必须读取从以前再次调用该函式之前调用返回的所有数据。
在离线模式下,HttpSendRequest返回ERROR_FILE_NOT_FOUND如果没有找到资源,在网际网路高速快取中。 此功能的HTTP伺服器传送指定的请求,并允许客户端指定另外的头与请求一起传送。
此功能的HTTP伺服器传送指定的请求,并允许客户端指定另外的头与请求一起传送。
该功能还可以让客户端指定可选的数据传送到HTTP伺服器请求头紧随。 该特徵通常用于“写”操作,如PUT和POST。
传送请求后,从HTTP伺服器的状态代码和回响报头被读取。 这些头在内部进行维护,并提供给客户端应用程式通过HttpQueryInfo功能。
应用程式可以使用相同的HTTP请求句柄多次调用HttpSendRequest ,但应用程式必须读取从以前再次调用该函式之前调用返回的所有数据。
在离线模式下,HttpSendRequest返回ERROR_FILE_NOT_FOUND如果没有找到资源,在网际网路高速快取中。 此功能的HTTP伺服器传送指定的请求,并允许客户端指定另外的头与请求一起传送。