共用方式為

SetDefaultLayoutOrTip 函式

  • 發行項

將指定的鍵盤配置或文字服務設定為目前用戶的預設輸入專案。

語法

BOOL CALLBACK SetDefaultLayoutOrTip(
  _In_ LPCWSTR           psz,
  _In_ LPCWSTR psz DWORD dwFlags
);

參數

psz [in]

表示鍵盤配置清單或文字服務配置檔清單的字串。

dwFlags [in]

指定下列旗標的 bitfield。

注意

公用頭檔中未定義下列標識碼。 您必須使用十六進位值或 #define 識別碼。 例如，若要使用SDLOT_NOAPPLYTOCURRENTSESSION您必須在程式代碼中包含 #define SDLOT_NOAPPLYTOCURRENTSESSION 0x00000001。

值 意義
SDLOT_NOAPPLYTOCURRENTSESSION
0x00000001
 將設定儲存在登錄中，但不會更新目前會話的運行時間鍵盤設定。 如果在 SetDefaultLayoutOrTipUserReg 中設定替代登錄路徑，則應該設定此旗標。
SDLOT_APPLYTOCURRENTTHREAD
0x00000002
 立即在目前線程上套用設定。

傳回值

傳回碼 描述
TRUE
 函式成功。
假
 發生未指定的錯誤。

備註

設定清單的字串格式為：

<LangID 1>：<KLID 1>;[...<LangID N>：<KLID N>

文字服務設定檔案清單的字串格式為：

<LangID 1>：{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx}{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx};

以下是 psz 參數值的範例：

"0x0407:0x00000407"
"0x0407:0x00000407;0x040C:0x0000040C"
"0x0407:0x00000407;0x0412:{A028AE76-01B1-46C2-99C4-ACD9858AE02F}{B5FE1F02-D5F2-4445-9C03-C568F23C99A1};0x040C:0x0000040C"

範例

沒有可定義此函式的匯入連結庫，因此必須使用 LoadLibrary 和 GetProcAddress 取得此函式的指標。 下列範例示範如何取得此函式的指標。

注意

不正確地使用 LoadLibrary 可能會藉由載入錯誤的 DLL 來危害應用程式的安全性。 如需如何使用不同版本的 Microsoft Windows 正確載入 DLL 的相關信息，請參閱 Dynamic-Link 連結庫搜尋順序。

typedef HRESULT (WINAPI *PTF_ SETDEFAULTLAYOUTORTIP)(LPCWSTR psz);

HMODULE hInputDLL = LoadLibrary(TEXT("input.dll"));
BOOL bRet = FALSE;

if(hInputDLL == NULL)
{
    // Error loading module; fail as securely as possible. 
}
else
{
    PTF_ SETDEFAULTLAYOUTORTIP pfnSetDefaultLayoutOrTip;
    
    pfnSetDefaultLayoutOrTip = (PTF_ SETDEFAULTLAYOUTORTIP)GetProcAddress(hInputDLL, "SetDefaultLayoutOrTip");

    if(pfnSetDefaultLayoutOrTip)
    {
        bRet = (*pfnSetDefaultLayoutOrTip)(psz);
    }

    FreeLibrary(hInputDLL);
}

需求

需求 值
最低支援的用戶端
 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 [僅限傳統型應用程式]
DLL
Input.dll