GetSystemWow64Directory2A 関数 (wow64apiset.h)

  • [アーティクル]

指定したイメージ ファイル コンピューターの種類を使用して、 WOW64 で使用されるシステム ディレクトリのパスを取得します。 このディレクトリは、32 ビット Windows には存在しません。

構文

UINT GetSystemWow64Directory2A(
  [out] LPSTR lpBuffer,
  [in]  UINT  uSize,
  [in]  WORD  ImageFileMachineType
);

パラメーター

[out] lpBuffer

パスを受け取るバッファーへのポインター。 このパスの末尾は円記号ではありません。

[in] uSize

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

[in] ImageFileMachineType

テストするマシンを指定する IMAGE_FILE_MACHINE_* 値。

戻り値

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

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

複数の WOW64 アーキテクチャをサポートするシステムでは、 GetSystemWow64Directory2 を使用して、 ImageFileMachineType で指定された WOW64 アーキテクチャに関連付けられている適切なシステム ディレクトリを取得できます。

WOW64 では、システム ディレクトリを使用して、共有 32 ビット コードを 64 ビット Windows に格納します。 ほとんどのアプリケーションでは、このディレクトリに明示的にアクセスする必要はありません。

WOW64 の詳細については、「 32 ビット アプリケーションの実行」を参照してください。

注意

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

要件

   
サポートされている最小のクライアント Windows 10、バージョン 1511 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wow64apiset.h
Library Kernel32.dll
[DLL] Kernel32.lib

関連項目

GetSystemWow64Directory