GetWindowsDirectoryA 関数 (sysinfoapi.h)
Windows ディレクトリのパスを取得します。
この関数は、主にレガシ アプリケーションとの互換性のために提供されます。 新しいアプリケーションでは、コードを Program Files フォルダーに格納し、永続的なデータをユーザーのプロファイルのアプリケーション データ フォルダーに格納する必要があります。 詳細については、「ShGetFolderPath
構文
UINT GetWindowsDirectoryA(
[out] LPSTR lpBuffer,
[in] UINT uSize
);
パラメーター
[out] lpBuffer
パスを受け取るバッファーへのポインター。 このパスは、Windows ディレクトリがルート ディレクトリでない限り、円記号で終わることはありません。 たとえば、Windows ディレクトリの名前がドライブ C の Windows の場合、この関数によって取得される Windows ディレクトリのパスは C:\Windows です。 システムがドライブ C のルート ディレクトリにインストールされている場合、取得されるパスは C: です。
[in] uSize
lpBuffer パラメーターで指定されたバッファーの最大サイズ (TCHAR)。 この値は MAX_PATHに設定する必要があります。
戻り値
関数が成功した場合、戻り値はバッファーにコピーされた文字列の長さになります(TCHARでは、終端の null 文字は含まれません。
長さがバッファーのサイズより大きい場合、戻り値はパスを保持するために必要なバッファーのサイズです。
関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError
備考
Windows ディレクトリは、一部のレガシ アプリケーションが初期化ファイルとヘルプ ファイルを格納するディレクトリです。 新しいアプリケーションでは、Windows ディレクトリにファイルを格納しないでください。代わりに、システム全体のデータをアプリケーションのインストール ディレクトリに格納し、ユーザー固有のデータをユーザーのプロファイルに格納する必要があります。
ユーザーがシステムの共有バージョンを実行している場合、Windows ディレクトリはユーザーごとにプライベートであることが保証されます。
アプリケーションがユーザーごとに保存する他のファイルを作成する場合は、HOMEPATH 環境変数で指定されたディレクトリにファイルを配置する必要があります。 このディレクトリは、ユーザー マネージャー管理ツールを使用して、管理者によって指定されている場合は、ユーザーごとに異なります。 HOMEPATH は常に、ユーザーのホーム ディレクトリ (各ユーザーに対してプライベートであることが保証されます) またはユーザーがすべてのアクセス権を持つ既定のディレクトリ (C:\USERS\DEFAULT など) を指定します。
ターミナル サービス: アプリケーションがターミナル サービス環境で実行されている場合、各ユーザーにはプライベート Windows ディレクトリがあります。
システム用の共有 Windows ディレクトリもあります。 アプリケーションがターミナル サービス対応 (イメージ ヘッダーに
例
例については、「システム情報の取得
手記
sysinfoapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetWindowsDirectory を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | sysinfoapi.h (Windows.h を含む) |
ライブラリ | Kernel32.lib |
DLL | Kernel32.dll |
関連項目
GetCurrentDirectory の
GetSystemDirectory の
GetSystemWindowsDirectory の