Initial crate

.gitattributes

@@ -0,0 +1,7 @@
+*       text=auto
+*       text eol=lf
+*.png   -text
+*.winmd -text
+*.dll   -text
+*.lib   -text
+*.a     -text

.github/LICENSE-APACHE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright (c) Microsoft Corporation.
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

.github/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Microsoft Corporation.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE

.github/SUPPORT.md

@@ -1,25 +1,25 @@
-# TODO: The maintainer of this repo has not yet edited this file
-
-**REPO OWNER**: Do you want Customer Service & Support (CSS) support for this product/project?
-
-- **No CSS support:** Fill out this template with information about how to file issues and get help.
-- **Yes CSS support:** Fill out an intake form at [aka.ms/spot](https://aka.ms/spot). CSS will work with/help you to determine next steps. More details also available at [aka.ms/onboardsupport](https://aka.ms/onboardsupport).
-- **Not sure?** Fill out a SPOT intake as though the answer were "Yes". CSS will help you decide.
-
-*Then remove this first heading from this SUPPORT.MD file before publishing your repo.*
-
-# Support
-
-## How to file issues and get help  
-
-This project uses GitHub Issues to track bugs and feature requests. Please search the existing 
-issues before filing new issues to avoid duplicates.  For new issues, file your bug or 
-feature request as a new Issue.
-
-For help and questions about using this project, please **REPO MAINTAINER: INSERT INSTRUCTIONS HERE 
-FOR HOW TO ENGAGE REPO OWNERS OR COMMUNITY FOR HELP. COULD BE A STACK OVERFLOW TAG OR OTHER
-CHANNEL. WHERE WILL YOU HELP PEOPLE?**.
-
-## Microsoft Support Policy  
-
-Support for this **PROJECT or PRODUCT** is limited to the resources listed above.
+# TODO: The maintainer of this repo has not yet edited this file
+
+**REPO OWNER**: Do you want Customer Service & Support (CSS) support for this product/project?
+
+- **No CSS support:** Fill out this template with information about how to file issues and get help.
+- **Yes CSS support:** Fill out an intake form at [aka.ms/spot](https://aka.ms/spot). CSS will work with/help you to determine next steps. More details also available at [aka.ms/onboardsupport](https://aka.ms/onboardsupport).
+- **Not sure?** Fill out a SPOT intake as though the answer were "Yes". CSS will help you decide.
+
+*Then remove this first heading from this SUPPORT.MD file before publishing your repo.*
+
+# Support
+
+## How to file issues and get help  
+
+This project uses GitHub Issues to track bugs and feature requests. Please search the existing 
+issues before filing new issues to avoid duplicates.  For new issues, file your bug or 
+feature request as a new Issue.
+
+For help and questions about using this project, please **REPO MAINTAINER: INSERT INSTRUCTIONS HERE 
+FOR HOW TO ENGAGE REPO OWNERS OR COMMUNITY FOR HELP. COULD BE A STACK OVERFLOW TAG OR OTHER
+CHANNEL. WHERE WILL YOU HELP PEOPLE?**.
+
+## Microsoft Support Policy  
+
+Support for this **PROJECT or PRODUCT** is limited to the resources listed above.

.github/workflows/build.yml

@@ -0,0 +1,67 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches:
+      - master
+env:
+  RUSTFLAGS: -Dwarnings
+
+jobs:
+  test:
+    name: Test
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+        - os: windows-latest
+          rust: stable
+          other: x86_64-pc-windows-msvc
+          platform: x64
+        - os: windows-latest
+          rust: nightly
+          other: i686-pc-windows-msvc
+          platform: x86
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+
+    - name: Update toolchain
+      run: rustup update --no-self-update ${{ matrix.rust }} && rustup default ${{ matrix.rust }}
+
+    - name: Add toolchain target
+      run: rustup target add ${{ matrix.other }}
+
+    - name: Build (${{ matrix.os }})
+      run: cargo test --all --target ${{ matrix.other }}
+
+  cargo_fmt:
+    name: Check cargo formatting
+    runs-on: windows-latest
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+
+    - name: Run cargo fmt
+      run: cargo fmt --all -- --check
+
+  cargo_clippy:
+    name: Check cargo clippy
+    runs-on: windows-latest
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+
+    - name: Run cargo clippy
+      run: cargo clippy --all -- -D warnings
+
+  cargo_doc:
+    name: Check cargo docs
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+
+    - name: Run cargo doc
+      run: cargo doc --no-deps

.gitignore

@@ -0,0 +1,9 @@
+.vscode
+.vs
+target
+packages
+obj
+bin
+*.lock
+*.user
+*.filters

.metadata/dia.manual.cs

@@ -0,0 +1,146 @@
+using Windows.Win32.Foundation;
+using Windows.Win32.Interop;
+
+namespace Microsoft.Dia
+{
+    public static unsafe partial class Apis
+    {
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_OK = unchecked(((int)(((uint)(1) << 31) | ((uint)(0x6d) << 16) | ((uint)(1)))));
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_USAGE = E_PDB_OK + 1;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_OUT_OF_MEMORY = E_PDB_OK + 2;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_FILE_SYSTEM = E_PDB_OK + 3;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_NOT_FOUND = E_PDB_OK + 4;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_INVALID_SIG = E_PDB_OK + 5;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_INVALID_AGE = E_PDB_OK + 6;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_PRECOMP_REQUIRED = E_PDB_OK + 7;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_OUT_OF_TI = E_PDB_OK + 8;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_NOT_IMPLEMENTED = E_PDB_OK + 9;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_V1_PDB = E_PDB_OK + 10;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_FORMAT = E_PDB_OK + 11;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_LIMIT = E_PDB_OK + 12;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_CORRUPT = E_PDB_OK + 13;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_TI16 = E_PDB_OK + 14;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_ACCESS_DENIED = E_PDB_OK + 15;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_ILLEGAL_TYPE_EDIT = E_PDB_OK + 16;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_INVALID_EXECUTABLE = E_PDB_OK + 17;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_DBG_NOT_FOUND = E_PDB_OK + 18;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_NO_DEBUG_INFO = E_PDB_OK + 19;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_INVALID_EXE_TIMESTAMP = E_PDB_OK + 20;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_RESERVED = E_PDB_OK + 21;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_DEBUG_INFO_NOT_IN_PDB = E_PDB_OK + 22;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_SYMSRV_BAD_CACHE_PATH = E_PDB_OK + 23;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_SYMSRV_CACHE_FULL = E_PDB_OK + 24;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_PDB_OBJECT_DISPOSED = E_PDB_OK + 25;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_DIA_INPROLOG = unchecked((int)(((uint)(1)<<31) | ((uint)(((uint)0x6d))<<16) | ((uint)(100))));
+
+        [NativeTypeName("HRESULT")]
+        public const int E_DIA_SYNTAX = E_DIA_INPROLOG + 1;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_DIA_FRAME_ACCESS = E_DIA_INPROLOG + 2;
+
+        [NativeTypeName("HRESULT")]
+        public const int E_DIA_VALUE = E_DIA_INPROLOG + 3;
+    }
+
+    public enum SymTag
+    {
+        SymTagNull,
+        SymTagExe,
+        SymTagCompiland,
+        SymTagCompilandDetails,
+        SymTagCompilandEnv,
+        SymTagFunction,
+        SymTagBlock,
+        SymTagData,
+        SymTagAnnotation,
+        SymTagLabel,
+        SymTagPublicSymbol,
+        SymTagUDT,
+        SymTagEnum,
+        SymTagFunctionType,
+        SymTagPointerType,
+        SymTagArrayType,
+        SymTagBaseType,
+        SymTagTypedef,
+        SymTagBaseClass,
+        SymTagFriend,
+        SymTagFunctionArgType,
+        SymTagFuncDebugStart,
+        SymTagFuncDebugEnd,
+        SymTagUsingNamespace,
+        SymTagVTableShape,
+        SymTagVTable,
+        SymTagCustom,
+        SymTagThunk,
+        SymTagCustomType,
+        SymTagManagedType,
+        SymTagDimension,
+        SymTagCallSite,
+        SymTagInlineSite,
+        SymTagBaseInterface,
+        SymTagVectorType,
+        SymTagMatrixType,
+        SymTagHLSLType,
+        SymTagCaller,
+        SymTagCallee,
+        SymTagExport,
+        SymTagHeapAllocationSite,
+        SymTagCoffGroup,
+        SymTagInlinee,
+        SymTagMax
+    }
+}

.metadata/generate.proj

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project Sdk="Microsoft.Windows.WinmdGenerator/0.15.2-preview">
+    <PropertyGroup Label="Globals">
+        <OutputWinmd>../.windows/winmd/Microsoft.Dia.winmd</OutputWinmd>
+        <WinmdVersion>255.255.255.255</WinmdVersion>
+        <DiaSdkRoot>$(VsInstallDir)\DIA SDK</DiaSdkRoot>
+        <DiaIdlRoot>$(DiaSdkRoot)\idl</DiaIdlRoot>
+        <DiaIncRoot>$(DiaSdkRoot)\include</DiaIncRoot>
+        <AdditionalIncludes>$(CompiledHeadersDir);$(DiaIncRoot)</AdditionalIncludes>
+    </PropertyGroup>
+    <ItemGroup>
+        <Idls Include="$(DiaIdlRoot)\dia2.idl" />
+        <Headers Include="$(CompiledHeadersDir)\dia2.h;$(DiaIncRoot)\cvconst.h" />
+        <Partition Include="main.cpp">
+            <TraverseFiles>@(Headers)</TraverseFiles>
+            <Namespace>Microsoft.Dia</Namespace>
+            <ExcludeFromCrossarch>true</ExcludeFromCrossarch>
+        </Partition>
+    </ItemGroup>
+</Project>

.metadata/main.cpp

@@ -0,0 +1,3 @@
+#include <windows.h>
+#include <dia2.h>
+#include <cvconst.h>

.metadata/options.rsp

@@ -0,0 +1,9 @@
+--remap
+SymTagEnum=SymTag
+__MIDL___MIDL_itf_dia2_0000_0043_0001=FPODATA
+--exclude
+SymTagEnum
+__MIDL___MIDL_itf_dia2_0000_0000_0001
+__MIDL___MIDL_itf_dia2_0000_0033_0001
+__MIDL___MIDL_itf_dia2_0000_0034_0001
+PfnPDBDebugDirV

Cargo.toml

@@ -0,0 +1,25 @@
+[package]
+name = "microsoft-dia"
+version = "0.1.0"
+authors = ["Microsoft"]
+edition = "2018"
+license = "MIT OR Apache-2.0"
+description = "Rust for Debug Interface Access (DIA) SDK"
+repository = "https://github.com/microsoft/dia-rs"
+documentation = ""
+readme = "README.md"
+exclude = [".github", ".windows", ".metadata", "docs", "tests"]
+
+[build-dependencies.windows]
+git = "https://github.com/microsoft/windows-rs"
+features = [
+    "build"
+]
+
+[dependencies.windows]
+git = "https://github.com/microsoft/windows-rs"
+features = [
+    "Win32_System_Com_StructuredStorage",
+    "Win32_System_Ole",
+    "Win32_Foundation"
+]

LICENSE

@@ -1,21 +0,0 @@
-    MIT License
-
-    Copyright (c) Microsoft Corporation.
-
-    Permission is hereby granted, free of charge, to any person obtaining a copy
-    of this software and associated documentation files (the "Software"), to deal
-    in the Software without restriction, including without limitation the rights
-    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-    copies of the Software, and to permit persons to whom the Software is
-    furnished to do so, subject to the following conditions:
-
-    The above copyright notice and this permission notice shall be included in all
-    copies or substantial portions of the Software.
-
-    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-    SOFTWARE

README.md

@@ -1,33 +1,56 @@
-# Project
+[![crates.io](https://img.shields.io/crates/v/microsoft-dia.svg)](https://crates.io/crates/microsoft-dia)
 
-> This repo has been populated by an initial template to help get you started. Please
-> make sure to update the content to build a great experience for community-building.
+## Rust for Debug Interface Access (DIA) SDK
 
-As the maintainer of this project, please make a few updates:
+The Microsoft Debug Interface Access Software Development Kit (DIA SDK) provides
+access to debug information stored in program database (.pdb) files generated by
+Microsoft postcompiler tools.
 
-- Improving this README.MD file to provide a great experience
-- Updating SUPPORT.MD with content about this project's support experience
-- Understanding the security reporting process in SECURITY.MD
-- Remove this section from the README
+- [Samples](https://github.com/microsoft/windows-samples-rs/)
 
-## Contributing
+Start by adding `windows` and `microsoft-dia` dependencies to Cargo.toml:
 
-This project welcomes contributions and suggestions.  Most contributions require you to agree to a
-Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
-the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
+```toml
+[dependencies.windows]
+git = "https://github.com/microsoft/windows-rs"
+features = [
+    "std",
+    "alloc",
+    "Win32_System_Com"
+]
 
-When you submit a pull request, a CLA bot will automatically determine whether you need to provide
-a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
-provided by the bot. You will only need to do this once across all repos using our CLA.
+[dependencies.microsoft-dia]
+git = "https://github.com/microsoft/dia-rs"
+version = "0.1.0"
+```
 
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
-contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+Make use of any DIA SDK APIs as needed.
 
-## Trademarks
+```rust
+fn main() -> windows::core::Result<()> {
+    unsafe {
+        CoInitializeEx(std::ptr::null_mut(), COINIT_MULTITHREADED)?;
 
-This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft 
-trademarks or logos is subject to and must follow 
-[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
-Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
-Any use of third-party trademarks or logos are subject to those third-party's policies.
+        let source: IDiaDataSource = CoCreateInstance(&DiaSource, None, CLSCTX_INPROC_SERVER)?;
+        let executable = std::env::current_exe().unwrap();
+        source.loadDataForExe(executable.as_os_str(), None, None)?;
+        let session = source.openSession()?;
+        let symbols = session.globalScope()?.findChildren(
+            SymTagFunction,
+            "sample::*",
+            nsfRegularExpression.0 as u32,
+        )?;
+
+        println!(
+            "Function symbols found in sample::* ({}):",
+            &executable.to_string_lossy()
+        );
+
+        for i in 0..symbols.Count()? {
+            println!("\t{}", symbols.Item(i as u32)?.name()?);
+        }
+
+        Ok(())
+    }
+}
+```

build.rs

@@ -0,0 +1,5 @@
+fn main() {
+    windows::core::build!({
+        Microsoft::Dia::*
+    });
+}

rustfmt.toml

@@ -0,0 +1,2 @@
+newline_style = "Unix"
+max_width = 500

src/lib.rs

@@ -0,0 +1,3 @@
+windows::core::include_bindings!();
+
+pub use Microsoft::Dia::*;