Функция GetSystemWow64Directory2W (wow64apiset.h)

Статья
11/20/2024

Извлекает путь к системному каталогу, используемому WOW64, используя указанный тип файлового компьютера образа. Этот каталог отсутствует в 32-разрядной версии Windows.

Синтаксис

UINT GetSystemWow64Directory2W(
  [out] LPWSTR lpBuffer,
  [in]  UINT   uSize,
  [in]  WORD   ImageFileMachineType
);

Параметры

[out] lpBuffer

Указатель на буфер для получения пути. Этот путь не заканчивается обратной косой чертой.

[in] uSize

Максимальный размер буфера в TCHARs.

[in] ImageFileMachineType

Значение IMAGE_FILE_MACHINE_*, указывающее компьютер для тестирования.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение имеет длину в TCHARs, строки, скопированной в буфер, а не включающее завершающий символ NULL. Если длина превышает размер буфера, возвращаемое значение — это размер буфера, необходимый для хранения пути.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

В системах, поддерживающих несколько архитектур WOW64, можно использовать GetSystemWow64Directory2 для получения соответствующего системного каталога, связанного с архитектурой WOW64, указанной ImageFileMachineType.

WOW64 использует системный каталог для хранения общего 32-разрядного кода в 64-разрядной версии Windows. Большинству приложений не требуется явным образом обращаться к этому каталогу.

Дополнительные сведения о WOW64 см. в запуска 32-разрядных приложений.

Заметка

Заголовок wow64apiset.h определяет GetSystemWow64Directory2 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1511 [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2016 [только классические приложения]
целевая платформа	Виндоус
заголовка	wow64apiset.h
библиотеки	Kernel32.dll
DLL	Kernel32.lib

См. также

GetSystemWow64Directory

Поделиться через