다음을 통해 공유


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이 아닌 값으로 설정하는 경우 검색 메커니즘은 적절하게 명명된 폴더와 연결된 중립 폴더만 검색합니다. 자세한 내용은 사용자 인터페이스 언어 관리를 참조하세요.

LoadMUILibraryLoadLibraryEx 함수를 기반으로 하며 사용법에도 유사한 고려 사항을 적용해야 합니다. 특히 LoadMUILibrary 에서 반환된 모든 핸들에 대해 FreeMUILibrary를 호출해야 합니다. 또한 LoadMUILibraryDllMain에서 호출해서는 안 됩니다. 자세한 내용은 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

다국어 사용자 인터페이스

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