��Z��Windows Server 2012 r2环境部��vSharePoint 2013 SP1

Eric_jiang — Mon, 11 Aug 2014 08:15:00 GMT

摘要: 在安装SharePoint 2013 服务器之前，请先了解��g和��Y件要求http://technet.microsoft.com/library/cc262485(office.15)?ocid=fwlink#section4Microsoft SharePoint 产品准备工具会�ؓ��h��内置数据库的单台服务器安装以下必备��Y�Ӟ��Web 服务�?(IIS) 角色应用�E�序服务器角色Microsoft .... 阅读全文

Eric_jiang 2014-08-11 16:15 发表评论

WinINet 学习资料

Eric_jiang — Wed, 21 Jul 2010 04:57:00 GMT

1.关于WinINet

WinINet不是�l�服务端用的�Q�服务端用Microsoft Windows HTTP Services (WinHTTP)

WinINet抽象了Gopher�Q�FTP�Q�HTTP协议的一些细节�?/div>

2.HINTERNET 句柄

WinINet函数创徏、��用的句柄都是HINTERNET�c�d��的，�q�种�c�d��的句柄无法被转换成其它类型的句柄。换句话��_��最好别用ReadFile、CloseHandle之类的函数来操作�q�些句柄。同��L��Q�也别用WinINet函数来访问、操作其他类型的句柄。比如，用InternetReadFile讉K��CreateFile创徏句柄是无法得��C��惌��的结果的。想关闭HINTERNET句柄要�� 用InternetCloseHandle函数�?/h4>

3.句柄架构

InternetOpen 创徏的句柄在��层�Q�由接下来的一层的 InternetOpenUrl �?InternetConnect 使用�Q��?InternetConnect 创徏的句柄又被之后的几个函数使用�?/p>
下面�q�张图是依赖 InternetOpenUrl 创徏的句柄的几个函数�Q�灰色的�Ҏ��是返�?HINTERNET 句柄的函敎ͼ�而白色的框就是��用被创徏�?HINTERNET 句柄的函�?/p>

FTP Hierarchy

HTTP Hierarchy

注意�q�张图，�q�张囄��意思是 HttpSendRequestEx 先访�?HttpOpenRequest 创徏的句柄之后， HttpEndRequest, InternetReadFileEx �?InternetWriteFile 才能讉K��q�个句柄�?HttpEndRequest 被调用之后，才轮的到InternetReadFile, InternetSetFilePointer �?InternetQueryDataAvailable 来访问这个句柄�?/p>

4.内容�~�码

HTTP 协议 (RFC 2616) 规定了应用程序可以要求服务器用编码的方式(encoded format)�q�回HTTP响应。在Windows Server 2008 �?Windows Vista之前�Q�发送给应用�E�序的内容编码了的请求需要应用程序自己处理，从Windows Server 2008 and Windows Vista开�? 应用�E�序可以�?WinINet 来解码了�Q�gzip与deflate�Q�。有三种方式开启解码选项�Q�基于会话、请求、连接）�Q�它们的作用域不同。可以��?a >InternetOpen(��Z��会话), InternetConnect(��Z��q�接), HttpOpenRequest(��Z��h��)�q�回的句柄调�?a >InternetSetOption 来打开或关闭解码选项,打开则将 dwOption 参数中INTERNET_OPTION_HTTP_DECODING 选项打开, �?lpBuffer 指向一个�ؓtrue的boolean变量. 关闭�?em>dwOption 参数中INTERNET_OPTION_HTTP_DECODING 选项打开, �?lpBuffer 指向一个�ؓfalse的boolean变量 .

讄��解码选项之后�Q?WinInet 在你调用 InternetReadFile 是就会执行一�ơ解码。不�q�就��你打开了解码选项�Q�它也不一定就��Z��解码……当这�U�情况发生时�Q?InternetReadFile 函数会失败�ƈ�q�回ERROR_INTERNET_DECODING_FAILED.�q�个时候你可以选择��L��Accept-Encoding头重新发送一�ơ请求，或者把解码��x��然后自己来解码（�q�时你就得检查Content-Encoding头来判断�~�码方式了）�?/p>

5.协议无关函数

从Internet下蝲文�g (InternetReadFile, InternetSetFilePointer, InternetFindNextFile, InternetQueryDataAvailable).
讄��同步操作 (InternetSetStatusCallback).
查询、修改设�|?(InternetSetOption , InternetQueryOption).
关闭 HINTERNET 句柄 (InternetCloseHandle).
锁定、解锁资源文�?(InternetLockRequestFile , InternetUnlockRequestFile).

Function	Description
InternetFindNextFile	�l�箋文�g的枚举或搜烦. 需要以下函数创建的句柄 FtpFindFirstFile, GopherFindFirstFile, InternetOpenUrl
InternetLockRequestFile	允许用户锁定文�g. 需要以下函数创建的句柄 FtpOpenFile, GopherOpenFile, HttpOpenRequest, InternetOpenUrl .
InternetQueryDataAvailable	查询可用数据的数�? 需要以下函数创建的句柄 FtpOpenFile, GopherOpenFile, HttpOpenRequest .
InternetQueryOption	查询 Internet 讄��.
InternetReadFile	��d�� URL 数据. 需要以下函数创建的句柄 InternetOpenUrl, FtpOpenFile, GopherOpenFile, HttpOpenRequest .
InternetSetFilePointer	讄��文�g指针. 需要以下函数创建的句柄 InternetOpenUrl ( HTTP URL only) HttpOpenRequest (GET �Ҏ��).
InternetSetOption	配置 Internet 讄��.
InternetSetStatusCallback	讄��一个接收状态信息的回调函数. 分配一个回调函数给指定�?HINTERNET 句柄及从其演化而来的句�?
InternetUnlockRequestFile	解锁�?InternetLockRequestFile 锁定的文�?

��L��?/font>

函数 InternetReadFile 用来从一个由函数 InternetOpenUrl, FtpOpenFile, GopherOpenFile, HttpOpenRequest �q�回�?HINTERNET 句柄下蝲资源.

WinINet 提供了两�U�方法来下蝲整个资源

InternetQueryDataAvailable 函数.
利用 InternetReadFile 的返回�?/li>
InternetQueryDataAvailable 使用 InternetOpenUrl, FtpOpenFile, GopherOpenFile, HttpOpenRequest (�q�记得上面的那个图么�Q�这个函数需要在 HttpSendRequest 操作该句柄之后才能访问这个句�? 创徏的句柄。返回有效数据的字节�?font face="monospace">�Q�据此，我们��可以分配��够的内存�q�进行读取，但是�q�种�Ҏ��不保险，包头里的长度可能是过时的�Q�而且包头也可能会丢�?/font>

当所有数据都被读完的时候， InternetReadFile 会返�?字节被读�?lpdwNumberOfBytesRead 参数保存了读取的字节�?. 据此�Q�我们就可以循环调用 InternetReadFile 直到��d��l�束�?/p>

��L��文�g

先��?FtpFindFirstFile, GopherFindFirstFile, �?InternetOpenUrl �Q�然后将其返回的句柄作�ؓ参数传递给 InternetFindNextFile �q�行�l�箋查找�Q�持�l�调�?InternetFindNextFile 知道�q�回扩展的错误信�?ERROR_NO_MORE_FILES 来完成整个搜索，调用 GetLastError 来获取最后的错误信息.

6.HTTP 会话

使用 WinINet 函数讉K��WWW资源

(1)初始�?WWW �q�接

��服务类型设�?INTERNET_SERVICE_HTTP 调用 InternetConnect 来徏立一�?HTTP 会话

HINTERNET InternetConnect(
__in HINTERNET hInternet, //InternetOpen �q�回的句�?br /> __in LPCTSTR lpszServerName, //可以描述目标服务器的字符�?br /> __in INTERNET_PORT nServerPort,//目标服务器的端口
__in LPCTSTR lpszUsername,//用户�?br /> __in LPCTSTR lpszPassword,//密码
__in DWORD dwService,//使用的服务类�?br /> __in DWORD dwFlags,
__in DWORD_PTR dwContext
);

nServerPort

Value Meaning

INTERNET_DEFAULT_FTP_PORT

Uses the default port for FTP servers (port 21).

INTERNET_DEFAULT_GOPHER_PORT

Uses the default port for Gopher servers (port 70).

INTERNET_DEFAULT_HTTP_PORT

Uses the default port for HTTP servers (port 80).

INTERNET_DEFAULT_HTTPS_PORT

Uses the default port for Secure Hypertext Transfer Protocol (HTTPS) servers (port 443).

INTERNET_DEFAULT_SOCKS_PORT

Uses the default port for SOCKS firewall servers (port 1080).

INTERNET_INVALID_PORT_NUMBER

Uses the default port for the service specified by dwService.

ldwService

Value Meaning

INTERNET_SERVICE_FTP

FTP service.

INTERNET_SERVICE_GOPHER

Gopher service.

INTERNET_SERVICE_HTTP

HTTP service.

(2)建立��h��

调用 HttpOpenRequest 来徏立一�?HTTP ��h��Q�不�q�这个函��C��会自动把��h��发送出去，要发送请求需要调�?HttpSendRequest

HttpOpenRequest 原型

HINTERNET HttpOpenRequest(
__in HINTERNET hConnect, // InternetConnect 函数�q�回的句�?br /> __in LPCTSTR lpszVerb, // 动作�Q�有GET, PUT, POST。也可以讄��?NULL �Q�会被当成默认的 GET 来用
__in LPCTSTR lpszObjectName, // 一个描�q�C��h��资源的字�W�串�Q�当��h��一个默认页面时令这个参数指向一个空�?br /> __in LPCTSTR lpszVersion, // HTTP 版本�Q�这个参��Cؓ NULL �Ӟ��默认使用""HTTP/1.1""
__in LPCTSTR lpszReferer, // 说明了lpszObjectName是取自哪个文�Ӟ��可以设�ؓNULL
__in LPCTSTR *lplpszAcceptTypes, // 是一个指�?/font>LPCTSTR数组的指针！数组以一个NULL指针�l�束�?/em>指定了程序接受的内容的类型，设�ؓ�I�则不接�?��M��c�d��的内容，设�ؓ�I�Z��则等价于""text/*""�Q�即不接受文本文件以外的囄��{�文�Ӟ��只接受某�U�特定的文�g可以用类�?image/gif, image/jpeg"的方式。关于更多内容类�?��L��q�里
__in DWORD dwFlags, // 一般都可以讄��?0
__in DWORD_PTR dwContext // 一般都可以讄��?0
);

(3)��d��h��

HttpAddRequestHeaders 原型

BOOL HttpAddRequestHeaders(

   __in HINTERNET hConnect,//HttpOpenRequest �q�回的句�?/font>

   __in LPCTSTR lpszHeaders,//包含要添加到��h��中的头的字符串的指针�Q�每个头都要以一�?CR/LF ( "r"n"r"n ) 对结�?/font>

   __in DWORD dwHeadersLength,//lpszHeaders指向的字�W�串的长度（以TCHAR�c�d��讎ͼ�. 如果�q�个参数被设�?1�Q�则字符串被当作�?�l�尾的字�W�串处理�Q�自动计��该字符串的长度

   __in DWORD dwModifiers

);

dwModifiers

可以是下面这些值的�l�合

Value Meaning

HTTP_ADDREQ_FLAG_ADD

Adds the header if it does not exist. Used with HTTP_ADDREQ_FLAG_REPLACE.

HTTP_ADDREQ_FLAG_ADD_IF_NEW

Adds the header only if it does not already exist; otherwise, an error is returned.

HTTP_ADDREQ_FLAG_COALESCE

Coalesces headers of the same name.

HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA

Coalesces headers of the same name. For example, adding "Accept: text/*" followed by "Accept: audio/*" with this flag results in the formation of the single header "Accept: text/*, audio/*". This causes the first header found to be coalesced. It is up to the calling application to ensure a cohesive scheme with respect to coalesced/separate headers.

HTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON

Coalesces headers of the same name using a semicolon.

HTTP_ADDREQ_FLAG_REPLACE

Replaces or removes a header. If the header value is empty and the header is found, it is removed. If not empty, the header value is replaced.

(4)发送一个请�?/font>

HttpSendRequest

BOOL HttpSendRequest(
__in HINTERNET hRequest, //HttpOpenRequst �q�回的句�?br /> __in LPCTSTR lpszHeaders, //附加到请求上的头�Q�可以�ؓNULL
__in DWORD dwHeadersLength, //lpszHeaders指向的字�W�串的长度（以TCHAR�c�d��讎ͼ�. 如果�q�个参数被设�?1�Q�当调用的是HttpSendRequestA时则字符串被当作�?�l�尾的字�W�串处理�Q�自动计��该字符串的长度。当调用的是 HttpSendRequestW时就会��生一个错�?br /> __in LPVOID lpOptional, //当��用POST或PUT�Ҏ��Ӟ��q�个参数指向的数据会紧接着��h��被发送出厅R��没有需要发送的数据则可以设�|��ؓNULL
__in DWORD dwOptionalLength //lpOptional数据的字节长度，无数据时讄��?
);

(5)向服务器发送数�?/font>

�Ҏ��一�Q�参见上面HttpSentRequest的lpOptional参数的说�?/font>

�Ҏ��二：使用 InternetWriteFile 向一个句柄里发送数据，然后使用 HttpSendRequestEx 发�?/font>

(6)查询一个请求的信息

HttpQueryInfo

BOOL HttpQueryInfo(
__in      HINTERNET hRequest, /*�?HttpOpenRequest �?InternetOpenUrl �q�回的句�?/
__in      DWORD dwInfoLevel,/* Query Info Flags.*/

   __inout LPVOID lpvBuffer, /*用于存储查询�l�果的缓冲区�Q�不可�ؓNULL*/
__inout LPDWORD lpdwBufferLength,/*lpvBuffer指向的缓冲区的字节长�?br />          若函数执行成功，�q�个变量存储的是写到�~�冲区里的数据长度。如果数据是字符串则�q�回的长度不包括字符串的�l�束字符
         如果函数发生 ERROR_INSUFFICIENT_BUFFER 错误, 则这个变量里保存的是数据的实际字节长度程序需要根据这个长度重新分配内存，再执行一�ơ这个函�?/
__inout LPDWORD lpdwIndex /*没看大明白，不过��g��可以讄��为NULL
        Pointer to a zero-based header index used to enumerate multiple headers with the same name.
        When calling the function, this parameter is the index of the specified header to return.
        When the function returns, this parameter is the index of the next header.
        If the next index cannot be found, ERROR_HTTP_HEADER_NOT_FOUND is returned.*/
);

(7)�?/font> WWW 上下载资�?/font>

在调�?HttpOpenRequest �?HttpSendRequest 之后�Q?�E�序可以使用 InternetReadFile, InternetQueryDataAvailable, InternetSetFilePointer 来下载HTTP服务器上的资源了�?/font>

BOOL InternetQueryDataAvailable(//查询数据的长�?br /> __in HINTERNET hFile, //�?InternetOpenUrl, FtpOpenFile, GopherOpenFile, �?HttpOpenRequest
�q�回的句�?br /> __out LPDWORD lpdwNumberOfBytesAvailable, //用于存放数据长度的指�?br /> __in DWORD dwFlags, //保留参数�Q�置0
__in DWORD_PTR dwContext //保留参数�Q�置0
);

BOOL InternetReadFile( //��d��句柄的数�?/font>

__in    HINTERNET hFile, // InternetOpenUrl, FtpOpenFile, GopherOpenFile, HttpOpenRequest 创徏的句�?/font>

__out LPVOID lpBuffer, // 存放数据的缓冲区

__in    DWORD dwNumberOfBytesToRead, // 准备��d��的字节数

__out LPDWORD lpdwNumberOfBytesRead // ��d��了的字节�?/font>
);

DWORD InternetSetFilePointer( //讄��InternetReadFile的文件位�|�（莫非多线�E�下载就是用�q�个实现的？�Q�，服务器不支持随机讉K��的话函数调用会失败，如果 InternetReadFile已经��d��C��文�g的末��，�q�个函数的调用也会失败�?br /> __in HINTERNET hFile, //�?InternetOpenUrl (on an HTTP or HTTPS URL)创徏�? 或由HttpOpenRequest 创徏(使用 GET �?HEAD�Ҏ��Q�而且句柄已经�?HttpSendRequest 讉K��q�了).
�q�个句柄也不可以使用 INTERNET_FLAG_DONT_CACHE �?INTERNET_FLAG_NO_CACHE_WRITE 标志
__in LONG lDistanceToMove, //�U�d��的字节数。正数向后移动，负数向前�U�d��
__in PVOID pReserved, //保留参数�Q��ؓNULL
__in DWORD dwMoveMethod, //指定了移动指针时的参考点。FILE_BEGIN�Q��用这个标志时�Q�移动的字节数被当作无符��h��处理�Q�、FILE_CURRENT、FILE_END�Q�如果内容的长度无法获得�Q�则使用�q�个标志时会��p�|�Q?br /> __in DWORD_PTR dwContext //保留参数�Q��ؓNULL
);

Eric_jiang 2010-07-21 12:57 发表评论

Value	Meaning
INTERNET_DEFAULT_FTP_PORT	Uses the default port for FTP servers (port 21).
INTERNET_DEFAULT_GOPHER_PORT	Uses the default port for Gopher servers (port 70).
INTERNET_DEFAULT_HTTP_PORT	Uses the default port for HTTP servers (port 80).
INTERNET_DEFAULT_HTTPS_PORT	Uses the default port for Secure Hypertext Transfer Protocol (HTTPS) servers (port 443).
INTERNET_DEFAULT_SOCKS_PORT	Uses the default port for SOCKS firewall servers (port 1080).
INTERNET_INVALID_PORT_NUMBER	Uses the default port for the service specified by dwService.

Value	Meaning
INTERNET_SERVICE_FTP	FTP service.
INTERNET_SERVICE_GOPHER	Gopher service.
INTERNET_SERVICE_HTTP	HTTP service.

Value	Meaning
HTTP_ADDREQ_FLAG_ADD	Adds the header if it does not exist. Used with HTTP_ADDREQ_FLAG_REPLACE.
HTTP_ADDREQ_FLAG_ADD_IF_NEW	Adds the header only if it does not already exist; otherwise, an error is returned.
HTTP_ADDREQ_FLAG_COALESCE	Coalesces headers of the same name.
HTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA	Coalesces headers of the same name. For example, adding "Accept: text/" followed by "Accept: audio/" with this flag results in the formation of the single header "Accept: text/, audio/". This causes the first header found to be coalesced. It is up to the calling application to ensure a cohesive scheme with respect to coalesced/separate headers.
HTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON	Coalesces headers of the same name using a semicolon.
HTTP_ADDREQ_FLAG_REPLACE	Replaces or removes a header. If the header value is empty and the header is found, it is removed. If not empty, the header value is replaced.

激情内射亚洲一区二区三区爱妻,亚洲手机中文字幕,亚洲成AV人在线观看网址

��Z��Windows Server 2012 r2环境部��vSharePoint 2013 SP1

WinINet 学习资料

3.句柄架构

FTP Hierarchy

HTTP Hierarchy

��L���?/font>

��L��文�g

使用 WinINet 函数讉K��WWW资源

(1)初始�?WWW �q�接

���服务类型设�?INTERNET_SERVICE_HTTP 调用 InternetConnect 来徏立一�?HTTP 会话

(2)建立��h��

(3)��d����h��

(5)向服务器发送数�?/font>

(6)查询一个请求的信息

(7)�?/font> WWW 上下载资�?/font>

��L��?/font>

��服务类型设�?INTERNET_SERVICE_HTTP 调用 InternetConnect 来徏立一�?HTTP 会话

(3)��d��h��