次の方法で共有

GetSystemDirectoryA 関数 (sysinfoapi.h)

  • [アーティクル]

システム ディレクトリのパスを取得します。 システム ディレクトリには、ダイナミック リンク ライブラリやドライバーなどのシステム ファイルが含まれています。

この関数は、主に互換性のために提供されます。 アプリケーションは、コードを Program Files フォルダーに格納し、永続的なデータをユーザーのプロファイルのアプリケーション データ フォルダーに格納する必要があります。 詳細については、「ShGetFolderPathを参照してください。

構文

UINT GetSystemDirectoryA(
  [out] LPSTR lpBuffer,
  [in]  UINT  uSize
);

パラメーター

[out] lpBuffer

パスを受け取るバッファーへのポインター。 システム ディレクトリがルート ディレクトリでない限り、このパスは円記号で終わりません。 たとえば、システム ディレクトリの名前がドライブ C の Windows\System32 の場合、この関数によって取得されるシステム ディレクトリのパスは C:\Windows\System32 です。

[in] uSize

バッファーの最大サイズ (TCHAR)。

戻り値

関数が成功した場合、戻り値はバッファーにコピーされた文字列の長さ (TCHAR) であり、終端の null 文字は含まれません。 長さがバッファーのサイズより大きい場合、戻り値は、終端の null 文字を含め、パスを保持するために必要なバッファーのサイズです。

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

アプリケーションでは、システム ディレクトリにファイルを作成しないでください。 ユーザーがオペレーティング システムの共有バージョンを実行している場合、アプリケーションはシステム ディレクトリへの書き込みアクセス権を持っていません。

例

例については、「システム情報の取得を参照してください。

手記

sysinfoapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetSystemDirectory を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー sysinfoapi.h (Windows.h を含む)
ライブラリ Kernel32.lib
DLL Kernel32.dll

関連項目

GetCurrentDirectory の

GetWindowsDirectory の

SetCurrentDirectory

システム情報関数