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

Статья
11/20/2024

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

Синтаксис

UINT GetSystemWow64DirectoryA(
  [out] LPSTR lpBuffer,
  [in]  UINT  uSize
);

Параметры

[out] lpBuffer

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

[in] uSize

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

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

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

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

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

Замечания

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

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

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

Заметка

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

Требования

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

См. также

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

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