修改后的属性文件：

<CppRestSDKPath>$([MSBuild]::GetRegistryValue(`HKEY_LOCAL_MACHINESoftwareMicrosoftCppRestSDKOpenSourceRelease120v$(CppRestSDKVersionString)SDK`, `InstallDir`))</CppRestSDKPath>
<CppRestRuntimeBaseFileName>$(CppRestBaseFileName)120$(DebugFileSuffix)_$(CppRestSDKVersionFileSuffix)</CppRestRuntimeBaseFileName>

• 现在，打开在你喜欢的文本编辑器中，打开你的C++项目对应Visual Studio 中的vcxproj文件，在Project中加入下面一行。这样，你的项目就可以包含CppRest.props中的定义。值得注意的是，CppRest.props中有一行是引入已经拷贝的CppRest.props配置文件：<Import Project=”CppRest.props” />
• 在Visual Studio中打开对应项目，打开项目属性。在configuration Properties | VC++ Directories中的include Directories属性中加入C++ REST SDK安装路径下include子文件夹的完整路径。如果你使用的是默认安装文件夹，你需要添加的属性值为C:Program Files (x86)Microsoft Cpp REST SDK for VS 2013 v1.3SDKinclude。
• 在Configuration Properties | VC++ Directories中Library Directories属性中加入C++ REST SDK安装路径下lib子文件夹的完整路径.如果你使用的是默认安装文件夹，那么你需要添加的属性值为C:Program Files (x86)Microsoft Cpp REST SDK for VS 2013 v1.3SDKlib。
• 添加C++ REST SDK库。具体来说，在Configuration Properties | Linker | Input中的Additional Dependencies加入cpprest120d_1_3.lib文件。

现在，你的C++项目就可以开始和C++ REST SDK一起工作了。（你也可以在 Package Manager Console控制台，通过运行命令Install-Package cpprestsdk来安装最新版本的C++ REST SDK，同时，使用相应包来向已经建立的项目添加C++ REST SDK并完成相应设置。但是，在新项目中使用最新版本SDK的最佳方法，是按照上文所述的步骤进行配置和添加。）

通过参数执行一个异步的HTTP GET调用

下面的代码说明了一个Windows控制台应用程序，通过C++ REST SDK调用Flickr。这个例子使用了一个HTTP GET调用：http://api.flickr.com/services/rest/method=flickr.test.echo&name=value ，并且检索由服务器返回的状态代码，返回报头类型和长度，以及返回主体报文。（在使用这些代码之前，你需要按照前面描述的步骤配置你的Visual Studio项目。）

代码：

// The code includes the most frequently used includes necessary to work with C++ REST SDK
#include "cpprest/containerstream.h"
#include "cpprest/filestream.h"
#include "cpprest/http_client.h"
#include "cpprest/json.h"
#include "cpprest/producerconsumerstream.h"
#include <iostream>
#include <sstream>

using namespace ::pplx;
using namespace utility;
using namespace concurrency::streams;

using namespace web::http;
using namespace web::http::client;
using namespace web::json;

pplx::task<void> HTTPGetAsync()
{
    // I want to make the following HTTP GET: http://api.flickr.com/services/rest/?method=flickr.test.echo&name=value
    http_client client(U("http://api.flickr.com/services/rest/"));

    uri_builder builder;
    // Append the query parameters: ?method=flickr.test.echo&name=value
    builder.append_query(U("method"), U("flickr.test.echo"));
    builder.append_query(U("name"), U("value"));

    auto path_query_fragment = builder.to_string();

    // Make an HTTP GET request and asynchronously process the response
    return client.request(methods::GET, path_query_fragment).then([](http_response response)
    {
        // Display the status code that the server returned
        std::wostringstream stream;
        stream << L"Server returned returned status code " << response.status_code() << L'.' << std::endl;
        std::wcout << stream.str();

        stream.str(std::wstring());
        stream << L"Content type: " << response.headers().content_type() << std::endl;
        stream << L"Content length: " << response.headers().content_length() << L"bytes" << std::endl;
        std::wcout << stream.str();

        auto bodyStream = response.body();
        streams::stringstreambuf sbuffer;
        auto& target = sbuffer.collection();

        bodyStream.read_to_end(sbuffer).get();

        stream.str(std::wstring());
        stream << L"Response body: " << target.c_str();
        std::wcout << stream.str();
    });
}

#ifdef _MS_WINDOWS
int wmain(int argc, wchar_t *args[])
#else
int main(int argc, char *args[])
#endif
{
    std::wcout << L"Calling HTTPGetAsync..." << std::endl;
    // In this case, I call wait. However, you won’t usually want to wait for the asynchronous operations
    HTTPGetAsync().wait();

    return 0;
}
#ifdef _MS_WINDOWS
int wmain(int argc, wchar_t *args[])
#else
int main(int argc, char *args[])
#endif
{
    std::wcout << L"Calling HTTPGetAsync..." << std::endl;
       // In this case, I call wait. However, you won’t usually want to wait for the asynchronous operations
    HTTPGetAsync().wait();

    return 0;
}

代码中的wmain方法在Windows 中称为HTTPGetAsync方法，这个方法返回一个pplx::task实例来表示一个异步操作。在这个例子中，代码调用wait方法来处理返回的实例，因为在这个示例控制台应用中，只要打印出结果即可。但是，一般来说，你可能不会调用wait来处理返回的实例，这样不会阻塞UI操作。

HTTPGetAsync方法创建一个新的web::http::client:http_client实例，从而保持与Flickr REST API的连接，其中Flickr REST API的URI是http://api.flickr.com/services/rest/.The C++ REST SDK使用独立于平台的字符串，所以为了按照不同平台的方式处理字符，代码中使用了U(str)宏来取字符串常量并且转化为与平台相应的类型。typedef utility::string_t对应的就是平台的特点。

http_client client(U(“http://api.flickr.com/services/rest/”));

在这一句中，代码指定了客户端并且决定了请求对应的URI。其中的路径为/services/rest，它已经包含在用于创建HTTP客户端的URI中了。因此，不需要特别指定这个路径。代码中创建了web::http::uri::builder类的实例，从而允许你用增量的方式建立URIs。这是一种方便而优雅的方法来追加查询片段（通过使用U(str)宏）。两个调用append_query方法增加了必要的对URI生成器的查询，并首先将它们编码。然后，为生成器调用to_string方法，生成必要的查询片段来完成请求。

uri_builder builder;
builder.append_query(U("method"), U("flickr.test.echo"));
builder.append_query(U("name"), U("value"));
auto path_query_fragment = builder.to_string();

下面的代码是初始化模块用于创建请求并且返回结果task实例来代表异步操作。request方法表明，它需要建立一个HTTP GET请求（methods::GET），同时需要附加查询片段（path_query_fragment）。值得注意的是，then这个方法为执行的请求添加了一个延续的task。这样，延续的任务可以在任务执行之后，将http_response实例作为一个参数接收。因此，then之后的代码会在获得请求结果之后在一个新任务中执行。如果你读过同步代码的话，这里的代码也很容易阅读。很容易看见，在请求task完成之后，代码会被阻塞，直到then执行完毕。你不需要研究复杂的流程，你可以使用then来连接许多任务并且加上需要执行的代码。

return client.request(methods::GET, path_query_fragment).then([](http_response response)
{
…
});

在本例中，then这个部分中定义的代码是为了展现从服务器端返回的状态码，头部内容的类型和长度。将http_response作为后一个任务的参数接收，使得一切都易于访问。

std::wostringstream stream;</p>
std::wostringstream stream;
stream << L"Server returned returned status code " << response.status_code() << L'.' << std::endl;
std::wcout << stream.str();

stream.str(std::wstring());
stream << L"Content type: " << response.headers().content_type() << std::endl;
stream << L"Content length: " << response.headers().content_length() << L"bytes" << std::endl;
std::wcout << stream.str();

这里，简单的Flickr API调用，返回的XML如下所示。本例只是想介绍如何通过参数建立一个简单的HTTP GET请求，并且用C++ REST SDK处理返回结果。

<rspstat="fail">
<errcode="100"msg="Invalid API Key (Key has invalid format)"/>
</rsp>

处理返回结果的代码使用了一个流，来从请求中读取数据。本例中，为了简单，代码调用了read_to_end方法并且连续调用了一个get方法来等待任务中代码执行的结果。read_to_end会先定位到流的尾部，再开始读取，然后返回一个task<size_t>来说明读入的字符数。因此，你可以异步调用read_to_end方法，并且调用另一个task来处理then中返回的结果。在本例中，get方法等待任务完成，并且返回任务产生的结果。值得注意的是，当task是一个取消命令时，调用该方法会抛出task_canceled异常。一般来说，如果你另一个任务中的话，一般不会使用get(也是为了避免阻塞UI)。

auto bodyStream = response.body();
streams::stringstreambuf sbuffer;
auto& target = sbuffer.collection();

bodyStream.read_to_end(sbuffer).get();

stream.str(std::wstring());
stream << L"Response body: " << target.c_str();
std::wcout << stream.str();

正如你从本例中看到的那样，使用C++11和C++ REST SDK执行一个简单的HTTP GET请求相当简单。然后使得理解异步调用顺序变得简单，C++ REST SDK中不同的帮助使得必要的样板代码很少。

欢迎反馈。

原文 Using the Microsoft C++ REST SDK
转载翻译自 伯乐在线 - programmer_lin