PGET_SYSTEM_WOW64_DIRECTORY_A
コールバックシグネチャ
DWORD PGET_SYSTEM_WOW64_DIRECTORY_A(
LPSTR lpBuffer,
DWORD uSize
);パラメーター
| フィールド | 型 | 説明 |
|---|---|---|
| lpBuffer | LPSTR | パスを受け取るバッファーへのポインターです。このパスの末尾にバックスラッシュは付きません。 |
| uSize | DWORD | バッファーの最大サイズ(TCHARs 単位)です。 |
公式ドキュメント
WOW64 が使用するシステムディレクトリのパスを取得します。このディレクトリは 32 ビット版 Windows には存在しません。
戻り値
関数が成功すると、戻り値はバッファーにコピーされた文字列の長さ(TCHARs 単位)で、終端の null 文字は含みません。長さがバッファーのサイズより大きい場合、戻り値はパスを格納するために必要なバッファーのサイズです。
関数が失敗すると、戻り値は 0 です。拡張エラー情報を取得するには、 GetLastError を呼び出します。
32 ビット版 Windows では、この関数は常に失敗し、拡張エラーには ERROR_CALL_NOT_IMPLEMENTED が設定されます。
解説(Remarks)
WOW64 は、64 ビット版 Windows 上で共有される 32 ビットコードを格納するためにシステムディレクトリを使用します。ほとんどのアプリケーションでは、このディレクトリに明示的にアクセスする必要はありません。
WOW64 の詳細については、 Running 32-bit Applications を参照してください。
この関数を使用するアプリケーションをコンパイルするには、_WIN32_WINNT を 0x0501 以降として定義します。詳細については、 Using the Windows Headers を参照してください。
wow64apiset.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして、GetSystemWow64Directory を定義します。エンコード中立のエイリアスの使用と、エンコード中立でないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーを引き起こす可能性があります。詳細については、Conventions for Function Prototypes を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)