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 を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | sysinfoapi.h (Windows.h を含む) |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |