{"id":3756,"date":"2017-01-25T18:08:04","date_gmt":"2017-01-25T10:08:04","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/heaths\/?p=3756"},"modified":"2019-02-17T15:29:21","modified_gmt":"2019-02-17T22:29:21","slug":"documentation-available-for-the-setup-configuration-api","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/setup\/documentation-available-for-the-setup-configuration-api\/","title":{"rendered":"Documentation available for the Setup Configuration API"},"content":{"rendered":"<p>Visual Studio 2017 has brought <a href=\"https:\/\/blogs.msdn.microsoft.com\/heaths\/2016\/09\/15\/changes-to-visual-studio-15-setup\/\">big changes<\/a> to extensibility that allow developers to install extensions to different instances and install dependencies. In support of multiple instances, a fast API was required that tools can use to find and launch Visual Studio and related tools, or to install extensions.<\/p>\n<p>I previously published <a href=\"https:\/\/aka.ms\/setup\/configuration\/samples\">some samples<\/a>, and now <a href=\"https:\/\/aka.ms\/setup\/configuration\/docs\">documentation<\/a> for these APIs is available. The documentation is based on the runtime-callable wrapper (RCW) &#8211; the <a href=\"https:\/\/aka.ms\/setup\/configuration\/interop\">.NET interop assemblies<\/a> &#8211; for the <a href=\"https:\/\/aka.ms\/setup\/configuration\/native\">native configuration API<\/a>. The main difference is that the native API will return an <code>HRESULT<\/code> while the RCW will throw a <code>COMException<\/code> where the <code>ErrorCode<\/code> will be the same <code>HRESULT<\/code> the native code would&#8217;ve returned.<\/p>\n<p>If you have any feedback about the APIs, please feel free to leave comments below. Until we can update the documentation, I&#8217;d be happy to answer questions about the APIs below, or take a look at the <a href=\"https:\/\/aka.ms\/setup\/configuration\/samples\">samples<\/a> for usage. Questions about the samples can also be asked in the Q&amp;A section of the samples project site.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Visual Studio 2017 has brought big changes to extensibility that allow developers to install extensions to different instances and install dependencies. In support of multiple instances, a fast API was required that tools can use to find and launch Visual Studio and related tools, or to install extensions. I previously published some samples, and now [&hellip;]<\/p>\n","protected":false},"author":389,"featured_media":3843,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[14,20,45,46,49,57],"class_list":["post-3756","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","tag-development","tag-installation","tag-visual-studio","tag-vs","tag-vs15","tag-vs2017"],"acf":[],"blog_post_summary":"<p>Visual Studio 2017 has brought big changes to extensibility that allow developers to install extensions to different instances and install dependencies. In support of multiple instances, a fast API was required that tools can use to find and launch Visual Studio and related tools, or to install extensions. I previously published some samples, and now [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/posts\/3756","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/users\/389"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/comments?post=3756"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/posts\/3756\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/media\/3843"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/media?parent=3756"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/categories?post=3756"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/tags?post=3756"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}