Share via

LoadMUILibraryA 함수(muiload.h)

  • 아티클

특정 LN(언어 중립) 파일과 연결된 언어별 리소스에 대한 핸들을 반환합니다.

참고 DLL이 올바르게 언로드되도록 하려면 애플리케이션이 LoadMUILibrary 에 대한 각 호출과 FreeMUILibrary에 대한 해당 호출과 일치해야 합니다.
 

구문

HINSTANCE LoadMUILibraryA(
  [in] PCSTR  pszFullModuleName,
  [in] DWORD  dwLangConvention,
  [in] LANGID LangID
);

매개 변수

[in] pszFullModuleName

LN 파일의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] dwLangConvention

Windows Vista 이전 운영 체제에서 언어별 리소스 파일이 포함된 디렉터리 이름을 지정하는 명명 규칙을 지정하는 플래그입니다. 플래그는 함께 사용할 수 없으며 기본값은 MUI_LANGUAGE_NAME.

값 의미
MUI_LANGUAGE_ID
 언어 식별자 형식을 사용하여 언어별 리소스 파일이 포함된 폴더의 이름을 해석합니다.
MUI_LANGUAGE_NAME
 언어 이름 형식을 사용하여 언어별 리소스 파일이 포함된 폴더 의 이름을 해석합니다.
 

다음 플래그는 옵션으로 사용할 수 있으며 다른 플래그 중 하나와 함께 사용할 수 있습니다.

값 의미
MUI_LANGUAGE_EXACT
 식별된 언어에 대한 리소스가 리소스 파일에 없는 경우 pwszModuleName으로 지정된 기본 모듈을 검사 성공하면 해당 모듈에 핸들을 반환합니다.

[in] LangID

Windows Vista 이전 운영 체제의 사용자 인터페이스 리소스에 대한 언어 식별자입니다. 언어 식별자는 다음 로캘 정보 상수와 연결된 언어에 해당할 수 없습니다.

반환 값

성공하면 적절한 언어별 리소스 파일에 대한 핸들을 반환합니다.

이 함수는 실패할 경우 NULL 을 반환합니다. 확장된 오류 정보를 가져오기 위해 애플리케이션은 GetLastError를 호출할 수 있습니다.

설명

이 함수를 사용하면 Win32 MUI 리소스 기술을 사용하여 개발된 애플리케이션이 Windows Vista 이전 운영 체제에서 로드할 언어별 리소스 파일을 올바르게 확인할 수 있습니다. 이 함수를 사용하는 애플리케이션은 Windows Vista에서 특별히 빌드할 필요는 없지만 Windows Vista용 Microsoft Windows SDK 제공된 MUILoad 라이브러리와 정적으로 연결해야 합니다. 이 함수를 사용하려면 표준 규칙을 사용하여 실행 파일 및 언어별 리소스 파일을 저장해야 합니다. 파일 배치에 대한 자세한 내용은 애플리케이션 배포 를 참조하세요.

다음 항목은 이 함수에 의한 위성 이진 파일 로드에 영향을 미칩니다.

  • 함수를 호출하는 애플리케이션을 실행하는 운영 체제 버전
  • dwLangConvention 매개 변수에 전달된 플래그
  • LangID 매개 변수에 전달된 언어 식별자의 상태
Windows Vista에서 실행하는 경우 이 함수는 리디렉션 없이 기본 모듈을 로드합니다. 리소스 로더 함수가 호출되면 리디렉션을 적절하게 수행하므로 pszFullModuleName 매개 변수만 사용됩니다. Windows Vista 이전 운영 체제에서 실행하는 경우 이 함수는 애플리케이션이 제공하는 모든 매개 변수를 고려합니다. pszFullModuleName으로 표시되는 파일과 연결된 적절한 위성 이진 쌍으로 이진 로드를 리디렉션합니다. 이 프로세스는 리소스 로더 함수의 근간이 되는 Windows Vista의 동작을 모방하기 위해 파일과 연결된 경로를 재구성합니다.

애플리케이션은 dwLangConvention 매개 변수를 사용하여 위성 이진 파일을 검색하는 방법을 지정합니다. 애플리케이션이 이 매개 변수를 MUI_LANGUAGE_ID 설정하면 이진 파일은 16진수 문자열 값이 있는 폴더에서 검색됩니다. (이러한 값은 선행 0x를 포함하지 않으며 길이는 4자입니다. 예를 들어 en-US가 표시됩니다.

"0409"로, en을 "0009"로 지정합니다.) 애플리케이션이 매개 변수를 MUI_LANGUAGE_NAME 설정하는 경우 함수는 언어 이름 기반 폴더 프로브를 사용하여 위성 파일을 찾는 Windows Vista 리소스 로드를 사용합니다.

LangID 매개 변수의 언어 식별자 상태는 리소스 검색에 영향을 줍니다. 애플리케이션이 이 매개 변수를 0으로 설정하면 함수는 운영 체제에 종속된 미리 정의된 대체 논리를 사용하여 적절한 언어별 리소스 파일을 찾습니다. 애플리케이션이 LangID 를 0이 아닌 값으로 설정하는 경우 검색 메커니즘은 적절하게 명명된 폴더와 연결된 중립 폴더만 검색합니다. 자세한 내용은 사용자 인터페이스 언어 관리를 참조하세요.

LoadMUILibrary 는 LoadLibraryEx 함수를 기반으로 하며 사용법에도 유사한 고려 사항을 적용해야 합니다. 특히 LoadMUILibrary 에서 반환된 모든 핸들에 대해 FreeMUILibrary를 호출해야 합니다. 또한 LoadMUILibrary 는 DllMain에서 호출해서는 안 됩니다. 자세한 내용은 LoadLibraryEx 및 FreeLibrary 의 설명 섹션 을 참조하세요.

참고

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 muiload.h
라이브러리 Muiload.lib
재배포 가능 파일 Windows 2000 Professional, Windows 2000 Server, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 및 Windows 7에서 실행할 수 있는 Windows 7용 Windows SDK 포함된 Muiload.lib입니다.

추가 정보

FreeMUILibrary

다국어 사용자 인터페이스

다국어 사용자 인터페이스 함수