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

  • Статья

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

Синтаксис

UINT GetSystemWow64DirectoryA(
  [out] LPSTR 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

См. также

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