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。 例如，如果使用者已啟用 CHT New Quick IME， EnumEnabledLayoutOrTip 函式會傳回所有 5 個 CHT IME。
備註
沒有可定義此函式的匯入程式庫，因此必須使用 LoadLibrary 和 GetProcAddress取得此函式的指標。
注意
不正確地使用 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 |
|