GetSystemWow64Directory2A 함수(wow64apiset.h)

지정된 이미지 파일 컴퓨터 형식을 사용하여 WOW64에서 사용하는 시스템 디렉터리의 경로를 검색합니다. 이 디렉터리가 32비트 Windows에 없습니다.

구문

UINT GetSystemWow64Directory2A(
  [out] LPSTR lpBuffer,
  [in]  UINT  uSize,
  [in]  WORD  ImageFileMachineType
);

매개 변수

[out] lpBuffer

경로를 수신할 버퍼에 대한 포인터입니다. 이 경로는 백슬래시로 끝나지 않습니다.

[in] uSize

TCHAR에서 버퍼의 최대 크기입니다.

[in] ImageFileMachineType

테스트할 컴퓨터를 지정하는 IMAGE_FILE_MACHINE_* 값입니다.

반환 값

함수가 성공하면 반환 값은 종료 null 문자를 포함하지 않고 버퍼에 복사된 문자열의 길이( TCHAR)입니다. 길이가 버퍼 크기보다 크면 반환 값은 경로를 보유하는 데 필요한 버퍼의 크기입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

여러 WOW64 아키텍처를 지원하는 시스템에서 GetSystemWow64Directory2 를 사용하여 ImageFileMachineType으로 지정된 WOW64 아키텍처와 연결된 적절한 시스템 디렉터리를 검색할 수 있습니다.

WOW64는 시스템 디렉터리를 사용하여 64비트 Windows에 공유 32비트 코드를 저장합니다. 대부분의 애플리케이션은 이 디렉터리에 명시적으로 액세스할 필요가 없습니다.

WOW64에 대한 자세한 내용은 32비트 애플리케이션 실행을 참조하세요.

참고

wow64apiset.h 헤더는 GETSystemWow64Directory2를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 10 버전 1511 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 wow64apiset.h
라이브러리 Kernel32.dll
DLL Kernel32.lib

참고 항목

GetSystemWow64Directory