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

Статья
08/28/2023

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

Синтаксис

UINT GetSystemWow64DirectoryW(
  [out] LPWSTR lpBuffer,
  [in]  UINT   uSize
);

Параметры

[out] lpBuffer

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

[in] uSize

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

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

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

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

В 32-разрядной версии Windows функция всегда завершается сбоем, а для расширенной ошибки задано значение ERROR_CALL_NOT_IMPLEMENTED.

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

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

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0501 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Примечание

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

Требования

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

См. также

Системные информационные функции