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

  • Статья

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

Синтаксис

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

Параметры

[out] lpBuffer

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

[in] uSize

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

[in] ImageFileMachineType

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

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

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

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

Комментарии

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

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

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

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1511 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Целевая платформа Windows
Header wow64apiset.h
Библиотека Kernel32.dll
DLL Kernel32.lib

См. также раздел

GetSystemWow64Directory