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 が 1 つだけ有効になっている場合でも、すべての IME が返されます。 たとえば、ユーザーが CHT New Quick IME を有効にしている場合、 EnumEnabledLayoutOrTip 関数は 5 つの CHT IME をすべて返します。

注釈

この関数を定義するインポート ライブラリがないため、 LoadLibrary と GetProcAddress を使用してこの関数へのポインターを取得する必要があります。

Note

LoadLibrary を誤って使用すると、間違った DLL を読み込むことで、アプリケーションのセキュリティが損なわれる可能性があります。 異なるバージョンの Microsoft Windows で DLL を正しく読み込む方法については、「 ダイナミック リンク ライブラリの検索順序 」を参照してください。

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