# Windows

<br>

## **概要**

Windows SDKは、マイナンバーカードを利用した電子証明書の取得や署名の作成、利用者の最新基本4情報（氏名・住所・生年月日・性別）に関する同意申請など、公的個人認証に必要な機能をWindowsアプリに実装するための開発キットです。  
提供されるZIPファイルを解凍し、同梱されている「PrimagestTrustServicesFramework.h」ファイルを既存のWindowsアプリ（C++プロジェクト）に追加してリンカー設定を行うことで、利用を開始できます。  
これにより、マイナンバーカードをPC/SC対応のカードリーダーで読み取り、公的個人認証に必要な各種機能をWindowsアプリ上で実現できます。

:::info[情報]
Windows対応カードリーダーは[こちら](https://www.jpki.go.jp/prepare/reader_writer.html)をご確認ください
:::

## **セットアップ手順**

<Steps>
    <Step title="PrimagestTrustServicesFrameworkのパスをコピーする">
        ![PrimagestTrustServicesFrameworkのパスをコピーする.png](https://api.apidog.com/api/v1/projects/1125421/resources/371031/image-preview)
        ZIPファイルを解凍し、「PrimagestTrustServicesFramework」フォルダを右クリックし、「パスのコピー」をクリックします。
    </Step>
    <Step title="プロジェクトのプロパティを開く">
        ![プロジェクトのプロパティを開く.png](https://api.apidog.com/api/v1/projects/1125421/resources/371032/image-preview)
        ソリューションエクスプローラーから自身のプロジェクトを選択し、上部にあるプロパティマークをクリックします。
    </Step>
    <Step title="C/C++のインクルードディレクトリの設定">
        ![C/C++のインクルードディレクトリの設定.png](https://api.apidog.com/api/v1/projects/1125421/resources/371036/image-preview)
        サイドバーの「C/C++」から「全般」を選択し、「追加のインクルードディレクトリ」に先ほどコピーしたパスを貼り付けて「OK」または「適用」ボタンをクリックします。
    </Step>
    <Step title="PrimagestTrustServicesFrameworkフォルダを開く">
        ![PrimagestTrustServicesFrameworkフォルダを開く.png](https://api.apidog.com/api/v1/projects/1125421/resources/371037/image-preview)
        「PrimagestTrustServicesFramework」フォルダを開きます。
    </Step>
    <Step title="PrimagestTrustServicesFramework.hファイルをドラッグ＆ドロップ">
       ![framework.hファイルをドラッグ＆ドロップ.png](https://api.apidog.com/api/v1/projects/1125421/resources/371038/image-preview)
        ソリューションエクスプローラーのヘッダーファイル内に「PrimagestTrustServicesFramework.h」ファイルをドラッグ＆ドロップで追加します。
    </Step>
    <Step title="x64フォルダを開く">
        ![x64フォルダを開く.png](https://api.apidog.com/api/v1/projects/1125421/resources/371039/image-preview)
        1つ前のフォルダに戻り、「x64」フォルダを開きます。
    </Step>
    <Step title="Releaseフォルダのパスをコピーする">
        ![Releaseフォルダのパスをコピーする.png](https://api.apidog.com/api/v1/projects/1125421/resources/371040/image-preview)
        「Release」フォルダを右クリックし、「パスのコピー」をクリックします。
    </Step>
    <Step title="プロジェクトのプロパティを開く">
        ![プロジェクトのプロパティを開く.png](https://api.apidog.com/api/v1/projects/1125421/resources/371041/image-preview)
        再度、ソリューションエクスプローラーから自身のプロジェクトを選択し、上部にあるプロパティマークをクリックします。
    </Step>
    <Step title="リンカーのインクルードディレクトリの設定">
        ![リンカーのインクルードディレクトリの設定.png](https://api.apidog.com/api/v1/projects/1125421/resources/371042/image-preview)
        サイドバーの「リンカー」から「全般」を選択し、「追加のインクルードディレクトリ」に先ほどコピーしたパスを貼り付けて「OK」または「適用」ボタンをクリックします。
    </Step>
    <Step title="リンカーの依存ファイル設定">
        ![リンカーの依存ファイル設定.png](https://api.apidog.com/api/v1/projects/1125421/resources/371043/image-preview)
        サイドバーの「リンカー」から「入力」を選択し、「追加のファイル依存」に「PrimagestTrustServicesFramework.lib」を入力して「OK」または「適用」ボタンをクリックします。
    </Step>
    <Step title="include による SDK の呼び出し">
        ![include による SDK の呼び出し.png](https://api.apidog.com/api/v1/projects/1125421/resources/371044/image-preview)
        SDK を利用するコード内で、次のように「PrimagestTrustServicesFramework.h」をインクルードすることで、SDK 内の機能が利用可能になります。

```cpp
#include "PrimagestTrustServicesFramework.h"
```
    </Step>
</Steps>

<br>
