EnumEnabledLayoutOrTip 함수

지정된 사용자 설정의 사용 가능한 모든 키보드 레이아웃 또는 텍스트 서비스를 열거합니다.

구문

UINT EnumEnabledLayoutOrTip(
  _In_opt_ LPCWSTR            pszUserReg,
  _In_opt_ LPCWSTR            pszSystemReg,
  _In_opt_ LPCWSTR            pszSoftwareReg,
  _Out_    LAYOUTORTIPPROFILE *pLayoutOrTipProfile,
  _In_     UINT               uBufLength
);

매개 변수

pszUserReg [in, optional]

사용자의 레지스트리 경로입니다. 이 매개 변수가 NULL이면 HKEY_CURRENT_USER 사용됩니다.

pszSystemReg [in, optional]

시스템의 레지스트리 경로입니다. 이 매개 변수가 NULL이면 HKEY_LOCAL_MACHINE\System 사용됩니다.

pszSoftwareReg [in, optional]

소프트웨어의 레지스트리 경로입니다. 이 매개 변수가 NULL이면 HKEY_LOCAL_MACHINE\Software 사용됩니다.

pLayoutOrTipProfile [out]

LAYOUTORTIPPROFILE 배열을 수신하는 버퍼에 대한 포인터입니다.

uBufLength [in]

pLayoutOrTipProfile이 가리키는 버퍼의 길이입니다.

반환 값

pLayoutOrTipProfile이 NULL인 경우 사용자 설정에서 사용하도록 설정된 키보드 항목의 수입니다. 그렇지 않으면 pLayoutOrTipProfile에 복사되는 키보드 항목의 수입니다.

IME(입력 메서드 편집기) 언어의 경우 하나의 IME만 사용하도록 설정된 경우에도 모든 IME가 반환됩니다. 예를 들어 사용자가 CHT New Quick IME를 사용하도록 설정한 경우 EnumEnabledLayoutOrTip 함수는 5개의 CHT IME를 모두 반환합니다.

설명

이 함수를 정의하는 가져오기 라이브러리는 사용할 수 없으므로 LoadLibrary 및 GetProcAddress를 사용하여 이 함수에 대한 포인터를 가져와야 합니다.

참고

LoadLibrary를 잘못 사용하면 잘못된 DLL을 로드하여 애플리케이션의 보안을 손상할 수 있습니다. 다양한 버전의 Microsoft Windows에서 DLL을 올바르게 로드하는 방법에 대한 자세한 내용은 Dynamic-Link 라이브러리 검색 순서 를 참조하세요.

LAYOUTORTIPPROFILE의 정의는 다음과 같습니다.

typedef struct tagLAYOUTORTIPPROFILE {
    DWORD  dwProfileType;       // InputProcessor or HKL 
#define LOTP_INPUTPROCESSOR 1
#define LOTP_KEYBOARDLAYOUT 2
    LANGID langid;              // language id 
    CLSID  clsid;               // CLSID of tip 
    GUID   guidProfile;         // profile description 
    GUID   catid;               // category of tip 
    DWORD  dwSubstituteLayout;  // substitute hkl 
    DWORD  dwFlags;             // Flags 
    WCHAR  szId[MAX_PATH];      // KLID or TIP profile for string 
} LAYOUTORTIPPROFILE;

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
DLL	Input.dll